העברת הגדרות משלוח מ-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 בו-זמנית.

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

השמות של השדות הבאים שונו במשאב הגדרות המשלוח ב-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	כן	לא