העברת הגדרות משלוח מ-Content API for Shopping

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

כדי להשתמש ב-Merchant API כדי לקרוא מידע על הגדרות משלוח, משתמשים בבקשות הבאות:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings

מחליפים את {ACCOUNT_ID} במזהה הייחודי של החשבון שלכם ב-Merchant Center.

כדי לעדכן את פרטי הגדרות המשלוח באמצעות Merchant API, משתמשים בבקשות הבאות:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings:insert

מידע נוסף זמין במאמר שיטה: accounts.shippingSettings.insert.

השוואה בין Content API for Shopping לבין Merchant API

הנה השוואה לדוגמה בין Content API for Shopping לבין מקור המידע על הגדרות המשלוח ב-Accounts sub-API:

	Content API	Merchant API
כתובת URL	https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/shippingsettings/{ACCOUNT_ID}	https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings:insert
מזהים	{MERCHANT_ID}/shippingsettings/{ACCOUNT_ID}	{NAME}

ברשימה הבאה מפורטים העדכונים העיקריים במקור המידע בנושא הגדרות משלוח ב-Accounts sub-API בהשוואה ל-Content API for Shopping:

1. משתמשים ב-Merchant API צריכים להזין את הערך accounts/{ACCOUNT_ID}/shippingSettings בשדה {NAME} כדי לקבל את אותה התנהגות.
2. ‫Merchant API לא תומך בפעולות קריאה וכתיבה באזורים מותאמים אישית, כמו קבוצות לפי מיקום. אפשר לקרוא או לכתוב אזורים מותאמים אישית כמו קבוצות לפי מיקום רק באמצעות שירות האזורים.
3. שירות אחד ב-Merchant API תומך בכמה מדינות משלוח.
4. ב-Merchant API אין שיטה להצגת רשימה של הגדרות משלוח, בניגוד לשיטה shippingsettings.list ב-Content API.

שדות נתמכים חדשים

במשאב של הגדרות המשלוח ב-Accounts sub-API יש שדות חדשים בהשוואה ל-Content API for Shopping:

1. ‫warehouses: מספק מידע על מחסן לוגיסטי שבו מאוחסן המלאי וממנו מתבצעת האספקה.
2. מועדוני לקוחות: משתמשי Merchant API יכולים להזין פרטים של מועדוני לקוחות בהגדרות המשלוח שלהם.
3. ‫Etag: ‫Etag נועד לפתור בעיות אסינכרוניות כשמשתמשים שונים מנסים לעדכן את הגדרות המשלוח באמצעות Merchant API וממשק המשתמש של Merchant Center בו-זמנית.

שדות ששמם שונה

השמות של השדות הבאים שונו במשאב Shipping settings (הגדרות משלוח) ב-Accounts sub-API:

Content API for Shopping	משאב הגדרות המשלוח	תיאור
service	services	שירות משלוחים יחיד.
service.name	services.serviceName	שם השירות שמוזן באופן חופשי וחייב להיות ייחודי בחשבון Merchant Center.
service.deliveryCountry	services.deliveryCountries	קוד הטריטוריה של CLDR של המדינה שבה חל שירות המשלוחים.
service.currency	services.currencyCode	קוד ה-CLDR של המטבע שרלוונטי לשירות הזה.
service.deliveryTime.minTransitTimeInDays	services.deliveryTime.minTransitDays	מספר ימי העסקים המינימלי שחולפים ממועד ביצוע ההזמנה עד למשלוח שלה. לדוגמה, הערך 0 מציין מסירה ביום הקנייה והערך 1 מציין מסירה ביום המחרת.
service.deliveryTime.maxTransitTimeInDays	services.deliveryTime.maxTransitDays	מספר ימי העסקים המקסימלי שההזמנה נמצאת בהובלה.
service.deliveryTime.minHandlingTimeInDays	services.deliveryTime.minHandlingDays	מספר ימי העסקים המינימלי שחולפים ממועד ביצוע ההזמנה עד לשליחת המוצר ללקוח.
service.deliveryTime.maxHandlingTimeInDays	services.deliveryTime.maxHandlingDays	מספר ימי העסקים המקסימלי שחולף לפני שההזמנה נשלחת.
service.deliveryTime.cutoffTime.timezone	services.deliveryTime.cutoffTime.timeZone	מזהה אזור הזמן של סוף יום ההזמנות.
service.deliveryTime.transitTimeTable.postalCodeGroupName	services.deliveryTime.transitTimeTable.postalCodeGroupNames	השם של קבוצת המיקודים.
service.deliveryTime.transitTimeTable.transitTimeLabel	services.deliveryTime.transitTimeTable.transitTimeLabel	תווית זמן ההובלה של המוצר.
service.rate_group	services.rateGroups	הגדרות של קבוצות תעריפי משלוח.
service.rate_group.subtable	services.rateGroups.subtables	רשימה של טבלאות משנה.
service.rate_group.carrier_rate	services.rateGroups.carrierRates	רשימה של תעריפי ספקים.
service.minimumOrderValueTable.storeCodeSetWithMovs	services.minimumOrderValueTable.storeCodeSetWithMovs	רשימה של קבוצות קודי חנויות שבהן מחיר המינימום להזמנה זהה.

‫methods שהוסרו

אי אפשר להשתמש ב-shippingsettings.custombatch כדי לאחזר ולעדכן את הגדרות המשלוח של כמה חשבונות בבקשה אחת.

שדות שהוסרו

השדות הבאים מ-Content API for Shopping הוסרו ב-Merchant API. אין ב-Merchant API חלופה לשדות האלה.

• postal_code_group
• service
• Pickup_service
• Eligibility
• Scheduling_channel
• Delivery_time
• Holiday_cutoff
• Rate_group
  • single_value_alternative_list

Methods

הנה השוואה בין השיטות ב-Content API for Shopping לבין המשאב Shipping settings:

שיטה	Content API for Shopping	Merchant API
customBatch	כן	לא
get	כן	כן
update	כן	לא
insert	לא	כן
list	כן	לא
getSupportedCarrier	כן	לא
getSupportedHolidays	כן	לא