נתוני גרסה (גרסה 2.1)

‫18 באוגוסט 2025

אנחנו מוציאים משימוש את Content API, והוא יושבת באוגוסט 2026. מעבר אל Merchant API

‫19 ביוני 2025

Products Service

משאב מוצר

הוספנו את השדה maximum_retail_price כדי לאפשר ציון של מחיר קמעונאי מקסימלי (MRP) בהודו.

שירות התמיכה במוכרים

‫26 במאי 2025

שירות חשבונות

עכשיו אפשר להוסיף לחשבונות משתמשים עם הרשאת קריאה בלבד.

‫14 באפריל 2025

שירות חשבונות

בעתיד כבר לא תהיה דרישה כזו, ולכן שירות accounttaxיצא משימוש.

‫17 במרץ 2025

במסגרת השבתת ממשקי ה-API שקשורים להזמנות, השירותים הבאים הוצאו משימוש:

  • accounts.verifyphonenumber
  • returnpolicy

שירותים אחרים

נקודת הקצה הזו כבר לא נדרשת ואפשר להוציא אותה משימוש:

  • pubsubnotificationsettings

‫10 בפברואר 2025

נוספו השדות prerendered_out_of_court_dispute_settlement אל ProductIssue ואל AccountIssue.

שדות שיצאו משימוש alternate_dispute_resolution מ-RenderProductIssuesResponse ומ-RenderAccountIssuesResponse.

‫12 בדצמבר 2024

Products Service

הוספנו את השדה sustainability_incentives כדי לציין תמריצים לשמירה על הסביבה, כמו זיכוי מס או הנחה על מחיר המוצרים. אם לא מציינים ערך בשדה, הפריט לא עומד בדרישות לקבלת תמריצים כלשהם לקיימות.

Nov 15, 2024

Products Service

בLoyaltyProgram, נוסף השדה shipping_label כדי לציין את הזכאות. אם יש ערך בשדה, המשמעות היא שהמוצר הזה נהנה מהטבת משלוח לחברי מועדון. אם לא צוין ערך בשדה, הפריט לא עומד בדרישות להטבת משלוח של מועדון הלקוחות ברמת החברות שצוינה.

‫30 באוקטובר 2024

במסגרת סגירת ממשקי ה-API שקשורים להסדרים, השירותים הבאים הוצאו משימוש:

  • settlementreports
  • settlementtranscations

הסגירה של ממשקי API שקשורים להסדרי תשלומים קשורה לסגירה הקודמת של התוכנית BuyOnGoogle וממשקי API שקשורים להזמנות.

צפוי ששיחות לשירותים שצוינו ייכשלו עם תגובה Service was not found on the server.

16 באוקטובר 2024

המינוי update_mask ב-UpdateConversionSourceRequest הוא עכשיו OPTIONAL. אם לא מציינים מסכת עדכון, כל השדות שיש להם ערך לא ריק מתעדכנים.

‫26 באוגוסט 2024 (מוקדם יותר מהתאריך שצוין בהודעה המקורית)

במסגרת השבתת ממשקי ה-API שקשורים להזמנות, השירותים הבאים הוצאו משימוש:

  • orderinvoices
  • orderreports
  • orderreturns
  • orderreturns.labels
  • orders

צפוי ששיחות לשירותים שצוינו ייכשלו עם תגובה Service was not found on the server.

שירות OrderTrackingSignals לא הוצא משימוש והוא ממשיך להיות זמין.

‫10 באוגוסט 2024

שירותים של 'קונים ב-Google'

במסגרת סגירת ממשקי ה-API של 'קונים ב-Google', כל השיטות ב-BuyOnGoogleProgramService ייכשלו עם service was not found on the server.

‫19 ביולי 2024

Products Service

נוסף השדה member_price_effective_date. בעקבות העדכון הזה, אפשר לציין, אם רלוונטי, את טווח התאריכים שבהם מחיר המבצע לחברי מועדון בתוקף. אם לא מציינים ערך בשדה, המחיר לחברי מועדון תקף תמיד.

‫20 במאי 2024

Products Service

הוספת את LoyaltyPrograms. העדכון הזה מאפשר לכם לספק כמה רמות עם נקודות מועדון, מחירים וכו' שונים למוצר יחיד. צריך להשתמש בשדה הזה במקום בשדה LoyaltyProgram ביחיד.

שירות הדוחות

מדדים שהוצאו משימוש בתוכנית 'קונים ב-Google' בטבלה MerchantPerformanceView. אחרי העדכון הזה, שליפה של מדד כלשהו של 'קונים ב-Google' תחזיר 0. זה נכון גם לגבי ערכים היסטוריים של תאריכים קודמים.

מידע נוסף זמין במאמר בנושא הוצאה משימוש של 'קונים ב-Google'.

‫13 במאי 2024

Products Service

משאב מוצר

שינויים בשדה האישורים: נוסף certificationValue לשדה ProductCertification כדי לספק ערך אישור (שנקרא גם סיווג, רמה או ציון), שמאפשר למשתמשים להעלות מידע על אישור גם אם רשות האישורים לא מנפיקה קוד או מספר אישור.

מידע נוסף זמין במדריכים למוצרים.

‫6 במאי 2024

שירות הדוחות

נוסף סיווג יעילות לטבלה PriceInsightsProductView. הדירוג 'יעילות' מראה לכם באילו מוצרים צפויה העלייה הכי גדולה בביצועים אם המחיר ישתנה. הדירוג הזה משקף את השיפור הצפוי בביצועים אם מחיר המבצע ישתנה ואת ההפרש בין המחיר הנוכחי למחיר המוצע.

‫24 באפריל 2024

Products Service

משאב מוצר

נוספו שדות אופציונליים downpayment ו-creditType לתשלומים בתשלומים:

  • downpayment מציין את הסכום שהקונה צריך לשלם מראש כתשלום חד-פעמי.
  • ‫creditType מציין את סוג התשלום בתשלומים (finance או lease). השדה הזה רלוונטי רק למודעות למכירת רכב.

‫11 באפריל 2024

Products Service

משאב מוצר

  • הוספנו את מאפיין מחיר המינימום למשלוח חינם (FreeShippingThreshold) למשלוח ברמת המוצר. המאפיין הזה מאפשר למוֹכרים להזין מחיר מינימלי של מוצר כדי שעלות המשלוח תהיה חינם.
  • השתנה סטטוס החשיפה של LoyaltyPoints

‫10 באפריל 2024

Products Service

משאב מוצר

הוספת את LoyaltyProgram

‫9 באפריל 2024

Products Service

משאב מוצר

הוספנו את structuredTitle ואת structuredDescription כדי לספק שמות פריטים ותיאורי מוצרים שנוצרו על ידי AI.

‫3 באפריל 2024

שירות התמיכה במוכרים

הוספנו שדה user_input_action_option שמאפשר לשותפים לבקש סוג חדש של פעולה: BuiltInUserInputAction. הפעולה הזו מאפשרת לשותפים ליצור פונקציונליות מורכבת בשירות עצמי למוכרים, ישירות באפליקציה שלהם, במקום להפנות אותם אל Merchant Center.

נוספה שיטה חדשה לTriggerAction BuiltInUserInputAction. כדי לגשת לשיטה הזו, צריך לשלוח בקשה באמצעות הטופס הזה.

‫27 במרץ 2024

Products Service

משאב מוצר

הוספנו את AutoPricingMinPrice כאמצעי הגנה בפרויקטים 'הנחות אוטומטיות' ו'מבצעים דינמיים', כדי לוודא שההנחות על המוצרים של המוכרים לא יורידו את מחיר המוצר מתחת לערך הזה. כך שומרים על הערך והרווחיות של המבצע.

‫15 במרץ 2024

הוצאנו משימוש את התוכנית 'קונים ב-Google' לחיפוש ולשופינג. תוכלו להמשיך לצפות בהזמנות קיימות עד 31 באוקטובר 2024 באמצעות orders.list ו-orders.get.

‫8 במרץ 2024

שירות הדוחות

הוספנו את הדוח TopicTrendsView לשירות TopicTrendsView.Reports

מידע נוסף זמין במדריכי הדיווח שלנו.

6 במרץ 2024

שירות הדוחות

הוספנו דליות ודירוג של פוטנציאל קליקים למוצרים.

מידע נוסף זמין במדריכי הדיווח שלנו.

‫19 בפברואר 2024

שירות ConversionSources

הוסרו הערכים הבאים כמקורות המרה תקפים:

  • CROSS_CHANNEL_FIRST_CLICK
  • CROSS_CHANNEL_LINEAR
  • CROSS_CHANNEL_POSITION_BASED
  • CROSS_CHANNEL_TIME_DECAY

הסרנו את האפשרויות 60 ו-90 כימים של חלון מבט לאחור, והוספנו את האפשרות 40.

‫17 בינואר 2024

שירות POS

הוספנו ערכים חדשים לשדה matching_status_hint ב-PosStore, כדי שהמשתמשים יוכלו לקבל פרטים נוספים על הסיבות לכך שהתאמת החנות שלהם נכשלה.

‫11 בינואר 2024

שירות חשבונות

נוספו localProductManager ו-localProductManagement כסוג קישור ושירות בהתאמה לשיטה link. הם מאפשרים לקשר בין חשבונות כדי לנהל נתוני מוצרים בחנויות מקומיות.

‫29 בנובמבר 2023

שירות התמיכה במוכרים

הוספנו VERIFY_IDENTITY_IN_MERCHANT_CENTER סוג פעולה חיצונית לאימות זהות שצריך לבצע ב-Merchant Center.

שירות POS

הוספנו את השדות matching_status ו-matching_status_hint אל PosStore. השדות האלה מאפשרים למשתמשים לדעת מה סטטוס ההתאמה של חנות ה-POS לחנות בפרופיל העסק ב-Google, ומספקים רמזים לפתרון בעיות.

‫15 בנובמבר 2023

אין יותר תמיכה בנקודות הקצה repricingrules ו-repricingrules.repricingreports.

‫1 בנובמבר 2023

שירות הגדרות משלוח

אין יותר תמיכה ב-shipment_type=pickup.

‫18 באוקטובר 2023

שירות חשבונות

הוספנו את השדה Business Identity שמאפשר למוֹכרים להגדיר בעצמם ערכים מסוימים שחשובים לצרכנים.

‫10 באוקטובר 2023

הוספנו את Collection Point כסוג משלוח חדש של שירות הגדרות משלוח. מסירה בנקודת איסוף היא שירות שניתן על ידי צד שלישי (למשל, לא בבעלות המוכר) שבו הפריט נמסר למיקום של צד שלישי שמשויך לשירות (כמו נקודות משלוח ואיסוף של UPS), במקום למסור אותו ישירות לבית.

18 בספטמבר 2023

שירות הגדרות LIA

הוספנו את השיטה setOmnichannelExperience כדי לאפשר למשתמשים להגדיר את חוויית האומניצ'אנל שלהם (כלומר, הגדרות של חנות מקומית ואיסוף). בשלב הזה, האפשרות הזו זמינה רק למשתמשים שספק מערכת ה-POS שלהם מהימן מספיק כדי לאפשר הגדרות כאלה.

7 בספטמבר 2023

הוצאה משימוש של 'קונים ב-Google'

הוספת סטטוס חדש DEPRECATED לשיטה GetBuyOnGoogleProgramStastus. אי אפשר להפעיל מחדש את התוכנית או להשהות אותה ממצב כזה.

‫4 בספטמבר 2023

שירות התמיכה במוכרים

נוספה פעולה מובנית FIX_ACCOUNT_ISSUE לבעיות במוצרים שצריך לפתור ברמת החשבון. נוספה פעולה מובנית SHOW_ADDITIONAL_CONTENT שתשמש להצגת הצדקה מרשות לאומית.

‫28 באוגוסט 2023

שירות מבצעים

השיטה list נפתחה בשירות Promotions מגישה מוגבלת לגישה לכולם.

‫22 באוגוסט 2023

שירות התמיכה במוכרים

השקנו שירות תמיכה למוֹכרים. השירות הזה מספק תוכן תמיכה בנושא בעיות בחשבון ובעיות במוצרים.

4 באוגוסט 2023

שירות הדוחות

הוספנו את הדוח 'חשיפה לעומת המתחרים הקרובים' לשירות הדוחות.

מידע נוסף זמין במדריכי הדיווח שלנו.

25 ביולי 2023

שירות POS

משאב מלאי

מוסיפים שדות pickup_method ו-pickup_sla כדי לאפשר למוכרים לשלוח פרטי איסוף יחד עם נתוני המלאי.

‫14 ביולי 2023

שירות הדוחות

הוספנו את הדוחות 'חשיפה לעומת המתחרים' לשירות הדוחות.

מידע נוסף זמין במדריכי הדיווח שלנו.

‫7 ביולי 2023

Products Service

משאב מוצר

נוסף virtualModelLink כדי לספק כתובות URL לתמונות של מודלים תלת-ממדיים.

‫4 ביולי 2023

Products Service

משאב מוצר

הוספת שדה certifications כדי לספק אישורי מוצר, למשל לסימון יעילות אנרגטית של מוצרים על סמך מסד הנתונים של EPREL באיחוד האירופי.

26 ביוני 2023

שירות הגדרות משלוח

מילוי הזמנות מקומי

הוספנו את השדה no_delivery_post_cutoff כדי לאפשר למוֹכרים לבטל את ההצגה של משלוח מקומי ביום n+1 אם הם הגדירו שירות משלוחים של משלוח מקומי ביום n.

‫29 במאי 2023

שירות מבצעים

נוספה שיטה list לשירות Promotions.

שירות המלצות

מפעילים את האפשרות לביטול אינטראקציה בשיטה ReportInteraction של שירות ההמלצות.

‫9 במאי 2023

יעד Cloud Retail

תכונות נוספות של קמעונאות בענן

מוסיפים את השדה 'מאפיינים נוספים של קמעונאות בענן'. זהו שדה חוזר שמיועד לשימוש של לקוחות שמשתמשים ביעד Cloud Retail. אם משתמשים בשדה הזה, הוא יהיה זמין כשמשתמשים בתוכנית הקמעונאות בענן. הערך הזה ימופה לשדה המאפיינים במודל של מוצר Google Cloud Retail.

‫22 במאי 2023

שירות מבצעים

נוספה שיטה list לשירות Promotions.

‫11 באפריל 2023

שירות הגדרות משלוח

מילוי הזמנות מקומי

הוספנו את אפשרות המשלוח המקומי למוכרים שיוצרים הגדרת משלוח חדשה. הם יכולים להגדיר את ההגדרות של החנויות המקומיות בשדה החדש storeConfig. הפרטים האלה כוללים את רדיוס השירות, המועד האחרון להזמנה וקודי החנויות שמציעות משלוח מקומי.

‫3 באפריל

שירות ההמלצות

השקנו את שירות ההמלצות. השירות הזה מספק הצעות לשיפור הביצועים של חשבון המוכר, ומאפשר לדווח על קליקים של מוכרים על המלצות מועילות.

20 בפברואר 2023

שירות החשבונות

משאב החשבון

הוספנו קטע חדש Account.ConversionSettings במשאב Accounts.

שירות ConversionSources

הוספנו את השירות Conversion Sources (מקורות המרות), שמאפשר לנהל מקורות של המרות (חלק מהקטע Conversion Settings (הגדרות המרות) ב-Merchant Center).

‫16 בפברואר 2023

שירות הגדרות משלוח

אימות קוד החנות

כדי לוודא שקודי החנויות שייכים למוֹכר, אנחנו מאמתים אותם לפני שמעדכנים את הגדרות המשלוח.

אימות מוכרים של מודעות מלאי של חנויות מקומיות (LIA)

מעכשיו, המערכת מאמתת את המספרים של מוֹכרים שרשומים לתוכניות לפני שהיא מעדכנת את הגדרות המשלוח. המוֹכרים צריכים להשתתף באחת מהתוכניות הבאות:

  • LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLE
  • LOCAL_INVENTORY_ADS

9 בפברואר 2023

Promotions Service

הרחבנו את שירות המבצעים ל-6 אפשרויות נוספות targetCountry עם תמיכה מקומית contentLanguage

  • BR
  • ES
  • NL
  • JP
  • IT
  • KR

‫12 בינואר 2023

Products Service

משאב מוצר

נוסף מאפיין lifestyleImageLinks כדי לספק כתובות URL של תמונות סגנון חיים.

Nov 24, 2022

Promotion Service

הוספנו שדה חדש, promotionStatus, בקטע Promotions.PromotionStatus. זהו שדה לקריאה בלבד.

‫15 בנובמבר 2022

שירות הדוחות

הוספנו את הדוחות של Market Insights לשירות הדוחות.

עכשיו אפשר לשלוח שאילתות לשירות הדוחות לגבי הנושאים הבאים:

מידע נוסף זמין במדריכי הדיווח שלנו.

Nov 7, 2022

שירות פידים של נתונים

הוספנו תמיכה ב-feedLabel לשירות Datafeeds.

‫14 בספטמבר 2022

בוצע עדכון של feedLabel כדי לקבל כל מחרוזת.

‫9 באוגוסט 2022

נוספה feedLabel למוצרים.

עכשיו אפשר להשתמש ב-feedLabel במקום ב-targetCountry כדי לציין את המדינה של מזהי המבצעים. מזהי המבצעים בנויים עכשיו כך: online:language:feedLabel:offerId.

המאפיין feedLabel אוכלס באופן אוטומטי בערך targetCountry בפידים קיימים, כדי לשמור על תאימות לאחור.

הוצא משימוש targetCountry.

כדי לתמוך במוצרים בינלאומיים, הוצאנו משימוש את השדה targetCountry ב-Content API for Shopping. במקום זאת, מומלץ להשתמש בשדה shipping כדי לציין את מדינות היעד.

הפרמטר targetCountry מאוכלס עכשיו באופן אוטומטי בערך שאתם מציינים בפרמטר feedLabel.

.

פרטים נוספים זמינים בפוסט בבלוג בנושא תווית פיד מחליפה את מדינת היעד ב-Content API for Shopping.

‫8 בדצמבר 2021

שירות החשבונות

משאב החשבון

נוסף קטע חדש Account.AutomaticImprovements במשאב Accounts.

בקטע החדש הזה, מוכרים יכולים לעדכן פריטים באופן אוטומטי, לשפר את התמונות ואת הגדרות המשלוח.

‫25 באוקטובר 2021

Promotion Service

הוספת הפונקציה Get Promotion ל-Promotion API.

‫11 באוקטובר 2021

Shipping Settings API

הוספנו שדה חדש warehouse במשאב ShippingSettings כדי לאפשר למוכרים לנהל את המחסנים שאפשר להשתמש בהם ב-WarehouseBasedDeliveryTime.

הוספת שדה warehouseName חדש ב-WarehouseBasedDeliveryTime כדי להפנות אל warehouse לפי שם המחסן.

4 באוקטובר 2021

שירות החשבונות

משאב החשבון

הוספנו שדה חדש phone_verification_status בקטע Accounts.BusinessInformation. זהו שדה לקריאה בלבד, שמוגדר על ידי Accounts.VerifyPhoneNumber.

‫13 בספטמבר 2021

שירות BuyOnGooglePrograms

משאב BuyOnGoogleProgramStatus

נוספו שדות חדשים במשאב BuyOnGooglePrograms.BuyOnProgramStatus שמייצגים: ערוצי מכירות באינטרנט, מודלים עסקיים וטלפון שירות לקוחות.

שיטה חדשה: UpdateBuyOnGoogleProgramStatus

נוספה שיטה חדשה UpdateBuyOnGoogleProgramStatus שתאפשר לעדכן את המשאב BuyOnGooglePrograms.BuyOnProgramStatus המורחב.

‫6 בספטמבר 2021

שירות החשבונות

משאב החשבון

הוספנו שדה חדש korean_business_registration_number בקטע Accounts.BusinessInformation. השדה הזה ינוקה רק אם הוא מוגדר במפורש כמחרוזת ריקה.

30 באוגוסט 2021

Promotion Service

נוסף שירות חדש לקידום מכירות עם אפשרות להוספת קידום מכירות.

שירות הזמנות

הוספנו שיטה חדשה orders/captureOrder לגביית כספים לפני המשלוח.

סיבה חדשה לביטול הזמנה FAILED_TO_CAPTURE_FUNDS

Products Service

משאב מוצר

הוספנו את productLength, ‏ productHeight, ‏ productWidth ואת productWeight כדי לספק מידות ומשקל של מוצרים.

‫9 באוגוסט 2021

שירות RepricingRule

סוג RepricingRule

ערך enum חדש בשדה RepricingRuleType.

הוספת את TYPE_SALES_VOLUME_BASED ואת TYPE_COMPETITIVE_PRICE.

‫17 במאי 2021

שירות תוויות להחזרת הזמנות

נוסף שדה חדש, product_id, ב-CreateReturnRequest. המוֹכרים יכולים לציין את מזהה המוצר [product_id] או את מזהה פריט ההזמנה [line_item_id] כדי לזהות את הפריט להחזרה.

Products Service

הוספנו שיטה חדשה לעדכון מוצרים קיימים. אתם יכולים לעדכן מוצר על ידי ציון רק השדות שצריך לעדכן במקום את כל המוצר.

3 במאי 2021

שירות תוויות להחזרת הזמנות

הוספנו שיטות חדשות להעלאת תוויות להחזרת מוצרים בניהול המוכר (MMR). בעזרת orderreturns.labels.create החדש, אתם יכולים להעלות את תוויות המשלוח להחזרת מוצרים ולשתף אותן עם הלקוח.

26 באפריל 2021

Shipping Settings API

שדה warehouseBasedDeliveryTimes חדש ב-DeliveryTime כדי לתמוך בשירותי משלוחים שמחשבים את תאריך המסירה המשוער על סמך מיקום המחסן ושירות חברת התובלה שנבחר.

שדה eddServices חדש באובייקט CarriersCarrier להחזרת שמות השירותים שרלוונטיים לחישוב תאריך המסירה המשוער.

‫12 באפריל 2021

Products Service

משאב מוצר

שדה additionalSizeType חדש לתמיכה בעד 2 סוגי מידות לכל מוצר.

שינויים בשדה המשלוח: הוספנו את minHandlingTime, maxHandlingTime, minTransitTime ו-maxTransitTime אל ProductShipping כדי לספק מהירות משלוח ברמת המוצר.

‫28 בינואר 2021

שירות החשבונות

נוסף תמיכה בתוויות אוטומטיות למשאבי AccountLabel ו-Account. למידע נוסף, ראו את הקטע סוגי תוויות CSS במדריך לניהול תוויות CSS.

‫5 באוקטובר 2020

שירות CSSES

CSS Resource

הוספנו שירות חדש csses לאחזור מידע על דומיינים של שירותי השוואת מחירים ולהקצאת תוויות לדומיינים האלה. אפשר עכשיו להשתמש במשאב AccountLabel גם כדי ליצור תוויות ברמת קבוצת ה-CSS ולרשום אותן. מידע נוסף זמין במאמר ניהול תוויות CSS.

‫24 באוגוסט 2020

Products Service

משאב Products

שדה shoppingAdsExcludedCountries חדש להחרגת מבצעים מפרסום במדינות מסוימות.

המשאב Productstatuses

שדות חדשים: approvedCountries, pendingCountries ו-disapprovedCountries באובייקט destinationStatuses, שמספקים מידע על סטטוס המבצע מעבר ל-targetCountry.

שדה חדש: itemLevelIssues.applicableCountries.

‫10 באוגוסט 2020

שירות החשבונות

הוספנו משאב AccountLabel חדש לניהול תוויות של חשבונות Merchant Center ב-CSS Center. משתמשים ב-CSS Center יכולים עכשיו גם לפרט את חשבונות Merchant Center שלהם ולהקצות להם תוויות באמצעות השיטות accounts.list, accounts.get ו-accounts.updatelabels. מידע נוסף זמין במאמר ניהול תוויות CSS.

‫19 ביוני 2020

Products Service

משאב מוצר

שדות חדשים

שדות חדשים: productDetails,‏ productHighlights,‏ subscriptionCost ו-canonicalLink.

2 ביוני 2020

שירות הזמנות

הוספנו שיטות חדשות ליזום החזרים כספיים בלי לדרוש את החזרת המוצרים. עם התכונות החדשות orders.refunditem וorders.refundorder, אתם יכולים ליזום החזרים כספיים על הזמנות גם אם הלקוחות לא מחזירים את המוצרים.

‫27 באפריל 2020

שירות Orderreturns

נוספו שיטות חדשות acknowledge ו-process, ומסננים ושדות חדשים לשיטות קריאה (list, ‏ get).

קישור ל-GMB

הוספנו אפשרות לקשר חשבונות Merchant Center לחשבון GMB באמצעות מזהה חשבון GMB.

14 באפריל 2020

Settlement Report APIs

נוסף שירות חדש לקבלת דוחות סליקה.

9 במרץ 2020

Local Inventory API

הוספנו שירות חדש לשליחת נתוני מלאי בחנויות מקומיות.

‫2 במרץ 2020

Pubsub notification settings API

נוסף שירות חדש לניהול ההגדרות של התראות pubsub.

3 בדצמבר 2019

Products Service

הוספנו תמיכה בפידים משלימים של Content API בחשבונות מרובי לקוחות.

11 בספטמבר 2019

שירות הזמנות

נוספה תמיכה במשלוחים באיסוף עצמי בהזמנות ובתכונות של ארגז החול שקשורות לכך.

‫14 באוגוסט 2019

שירותים חדשים

הוספנו שירותים חדשים של מדיניות החזרת מוצרים וכתובת להחזרת מוצרים ל'קונים ב-Google'.

שירות הזמנות

משאב ההזמנה

שדה חדש

שדה חדש: quantityUndeliverable.

‫7 באוגוסט 2019

שירות הזמנות

משאב ההזמנה

שדות חדשים

נוספו השדות loyaltyInfo ו-invoiceReceivingEmail למשאב Order.

‫1 ביולי 2019

Products Service

הוספנו תמיכה בפידים משלימים ב-Content API בשירות Products.

‫11 ביוני 2019

שירות הזמנות

משאבי Order ו-TestOrder

הוספה של התאמת מחיר

נוסף שדה חדש lineItem[].adjustments שמכיל את ההתאמה למחיר המקורי של פריט השורה ולמס שנגרמו כתוצאה מהחלת מבצעים.

‫14 בפברואר 2019

השינויים שנוספו בגרסה הזו

אין יותר תמיכה בהרצות יבשות

הפרמטר dryRun הוסר מגרסה 2.1. הדרישה הזו חלה על כל הקריאות ל-API.

אין יותר תמיכה בשיטות תיקון

השירותים הבאים לא תומכים יותר בשיטה patch:

  • חשבונות
  • Accounttax
  • פידים של נתונים
  • Liasettings
  • Shippingsettings

הסרה של שיטות HTTP BATCH

כל השיטות של HTTP BATCH הוסרו מגרסה 2.1. במקום זאת, אתם צריכים להשתמש ב-customBatch. אלה השירותים שיושפעו:

  • חשבונות
  • Accountstatuses
  • פידים של נתונים
  • Datafeedstatuses
  • Liasettings
  • Orderreports
  • מקום
  • מוצרים
  • Productstatuses
  • Shippingsettings

שירות החשבונות

עדכון

השדות businessInformation ו-googleMyBusinessLink בבקשה נוספו אחרי ההשקה הראשונית של Content API v2. לכן, יש אמצעי הגנה שמונעים ממוֹכרים למחוק בטעות מידע בשני השדות האלה באמצעות update אם הם לא מסופקים.

בגרסה 2, מוכרים צריכים לספק את השדות האלה באופן מפורש עם גוף ריק ( {}) כדי למחוק אותם. בגרסה 2.1, שדות נמחקים אם מספקים גוף ריק או אם לא מספקים אותם.

משאב החשבון

שינוי המיתוג של AdWords ל-Google Ads

במסגרת השינוי של AdWords ל-Google Ads, השמות של השדות הבאים שקשורים ל-AdWords השתנו:

  1. ‫adwordsLinks -> ‏adsLinks
  2. ‫adwordsLinks.adwordsId -> ‏adsLinks.adsId
הסרה של שדות וערכים שהוצאו משימוש

השדה reviewsUrl שיצא משימוש הוסר. בנוסף, הוסר סטטוס הקישור inactive עבור adsLinks, googleMyBusinessLink ו-youtubeChannelLinks.

שירות Accountstatuses

המשאב AccountStatus

הסרה של dataQualityIssues

הן הוחלפו על ידי itemLevelIssues.

שירות פיד נתונים

משאב פיד נתונים

הסרה של שדות שיצאו משימוש

השדות contentLanguage, ‏targetCountry ו-intendedDestinations הוסרו והוחלפו בשדות country, ‏language, ‏includedDestinations ו-excludedDestinations ב-targets.

הסרה של עדכון מלאי מוצרים

הוסרו פידים מסוג product inventory update.

Inventory Service

שירות inventory מגרסה 2 הוסר והוחלף בשתי תכונות חדשות בגרסה 2.1:

  • כדי לעדכן חלק מנתוני המוצרים, צריך להשתמש בפידים משלימים חדשים.
  • כדי לעדכן מוצרים בחנויות מקומיות, משתמשים בשירות החדש localinventory.

שירות הזמנות

CancelLineItem

השדות amount,‏ amountPretax ו-amountTax הוסרו מהבקשה. הסכום שיוחזר מחושב עכשיו באופן אוטומטי.

CustomBatch

הוסר מגרסה 2.1.CustomBatch

InStoreRefundLineItem

השדות amountPretax ו-amountTax הוחלפו בשדות priceAmount ו-taxAmount, בהתאמה. הערך בשדה priceAmount יכול להיות לפני מס או אחרי מס, בהתאם למיקום של ההזמנה.

החזר כספי

השיטה הזו הוסרה. במקום זאת, אתם צריכים להשתמש ב-returnRefundLineItem.

ReturnLineItem

השיטה הזו הוסרה. במקום זאת, צריך להשתמש ב-returnRefundLineItem בלי לציין סכום החזר.

ReturnRefundLineItem

השדות amountPretax ו-amountTax הוחלפו בשדות priceAmount ו-taxAmount, בהתאמה. הערך בשדה priceAmount יכול להיות לפני מס או אחרי מס, בהתאם למיקום של ההזמנה.

ShipLineItem

השדות carrier,‏ shipmentId ו-trackingId בבקשה הועברו אל shipmentInfos.

משאבי Order ו-TestOrder

פורמט חדש של מבצע

בגרסה 2.1 יש פורמט חדש של מבצעים. אי אפשר ליצור הזמנות לבדיקה עם מבצעים.

הסרה של שדות שיצאו משימוש

השדה paymentMethod הוסר, והשדות billingAddress ו-predefinedBillingAddress הם עכשיו שדות ברמה העליונה ב-Order וב-TestOrder, בהתאמה.

בנוסף, customer.explicitMarketingPreference הוסר והוחלף ב-customer.marketingRightsInfo גם ב-Order וגם ב-TestOrder.

השדה customer.email שיצא משימוש הוסר.

הפורמט של השדה promotions השתנה במקור המידע Order.

שירות Orderpayments

השירות הזה הוסר מגרסה 2.1.

Products Service

התשובה מ-insert תכיל רק את המאפיינים הבאים:

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

אזהרות ושגיאות לא קריטיות לא מוחזרות יותר בתשובה. השינוי הזה מאפשר שילוב טוב יותר עם כללי פיד ועם תכונות מתקדמות אחרות לניהול פידים.

עכשיו יש עיכוב של כמה דקות לפני שאפשר לאחזר מוצר שהוכנס באמצעות get או list.

אין יותר ערובה לכך שמזהה המבצע שמוחזר יהיה זהה למזהה המבצע שהוזן.

המחירים מאומתים עכשיו לפני הוספת המוצר. מחרוזת הערך יכולה לכלול רק את התווים הבאים: +, -, . וספרות (0 עד 9). אי אפשר יותר להשתמש בפסיקים.

משאב מוצר

התכונה CustomGroups הוחלפה בתכונה recursive customAttributes

בעבר, אפשר היה לקבץ מאפיינים מותאמים אישית באמצעות הוספת מאפיינים מותאמים אישית לאותה קבוצה מותאמת אישית בגרסה 2. בגרסה 2.1, מאפיינים מותאמים אישית הם עכשיו רקורסיביים, ולכן אין יותר צורך בקבוצות מותאמות אישית.

למאפיינים מותאמים אישית יש עכשיו שדה נוסף groupValues בנוסף לשדה המקורי value. צריך להגדיר בדיוק אחד מהם, כלומר אי אפשר להגדיר את שניהם או לא להגדיר אף אחד מהם.

יכול להיות שמוכרים יעברו בין גרסה 2 לגרסה 2.1, ולכן יכול להיות שלמוצרים יהיו מאפיינים מותאמים אישית רקורסיביים שלא ניתן לייצג בגרסה 2, כי לקבוצות מותאמות אישית יש מקסימום שתי רמות. במקרה כזה, קבוצת המאפיינים המותאמים אישית תיחתך.

הסרה של type ו-unit ב-customAttributes

בגרסה 2.1, מאפיינים מותאמים אישית לא יכילו יותר את type ו-unit. במקום זאת, צריך לצרף את היחידות ל-value (אם הוא קיים), והסוגים צריכים להיות מזוהים באופן אוטומטי. לדוגמה, אפשר להשתמש בערך '‎1.23 EUR' או '‎5.6 cm' בתג value בגרסה 2.1.

המאפיין ProductTypes מחליף את המאפיינים productType ו-additionalProductTypes

בעבר, סוגי המוצרים אוחסנו בשני שדות. הסוג הראשון אוחסן בשדה היחיד productType והשאר בשדה החוזר additionalProductTypes. בגרסה 2.1, שני השדות הוחלפו בשדה חוזר אחד productTypes.

המאפיין 'יעדים' הוחלף במאפיינים 'יעדים כלולים' ו'יעדים מוחרגים'

יעדים הוזנו כרשימה של זוגות של שם יעד וכוונת משתמש בגרסה 2 בשדה החוזר destinations. השדה הזה הוחלף בשני שדות חוזרים: includedDestinations ו-excludedDestinations. אין צורך לכלול יעדים שמופעלים כברירת מחדל ב-includedDestinations.. כך תהיה התאמה להגדרת שינויים בהגדרות היעד בפידים.

במסגרת השינוי של AdWords ל-Google Ads, השמות של השדות הבאים שקשורים ל-AdWords השתנו:

  • ‫adwordsGrouping -> ‏adsGrouping
  • ‫adwordsLabels -> ‏adsLabels
  • ‫adwordsRedirect -> ‏adsRedirect
הסרה של שדות שיצאו משימוש

השדות הבאים שיצאו משימוש הוסרו:

  • aspects
  • destinations
  • onlineOnly
  • validatedDestinations
  • warnings

שירות Productstatuses

קבלת רשימה

המאפיין product הוסר, יחד עם הפרמטר includeAttributes. כדי לאחזר מאפיינים של המוצר שמתאימים לסטטוס, צריך להשתמש בשירות Products ובערך של השדה החדש productId.

רשימה

הפרמטר includeInvalidInsertedItems הוסר. כל המוצרים מוחזרים עכשיו בלי קשר לתוקף שלהם, כלומר הפונקציה list מתנהגת עכשיו כאילו includeInvalidInsertedItems תמיד מוגדר כ-true.

המשאב ProductStatus

DestinationsStatuses

השדות intention,‏ approvalStatus ו-approvalPending ב-destinationStatuses הוחלפו ב-status, שהוא מחרוזת שיכולה להיות אחת מהאפשרויות approved,‏ disapproved או pending.

הסרה של dataQualityIssues

הן הוחלפו על ידי itemLevelIssues.