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

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

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

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings

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

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

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert

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

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

לפניכם השוואה לדוגמה בין Content API for Shopping לבין Merchant Shipping settings API:

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

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

1. משתמשי Merchant API צריכים להזין את הערך accounts/{accountId}/shippingSettings בשדה {name} כדי לקבל את אותה התנהגות.
2. ב-Merchant API אין תמיכה בפעולות קריאה וכתיבה באזורים מותאמים אישית, כמו קבוצות מיקומים. אפשר לקרוא או לכתוב אזורים מותאמים אישית, כמו קבוצות לפי מיקום, רק באמצעות שירות האזור.
3. הדרך להגדיר את WarehouseBasedDeliveryTime שונה ב-Merchant API בהשוואה ל-Content API for Shopping. אם אתם משתמשים ב-Merchant API, עליכם להגדיר את פרטי המחסן בקטע shippingsettings.warehouses. לאחר מכן, כל שירות משלוחים יוכל להפנות למחסן באמצעות שם המחסן בקטע warehouseBaseDeliveryTime.
4. שירות אחד ב-Merchant API תומך בכמה מדינות משלוח.

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

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

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

שדות ששונו

השמות של השדות הבאים השתנו ב-Merchant API:

Content API for Shopping	Merchant Shipping settings API	תיאור
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	רשימה של קבוצות של קודי חנויות שיש להן אותו ערך הזמנה מינימלי.

שיטות שהוצאו משימוש

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

שדות שיצאו משימוש

השדות הבאים מ-Content API הוצאו משימוש ב-Merchant API. ב-Merchant API אין חלופה לשדות האלה.

• postal_code_group
• service
• Pickup_service
• Eligibility
• Scheduling_channel
• Delivery_time
• Holiday_cutoff
• Min_scheduling_time_in_days
• Max_scheduling_time_in_days
• Scheduling_business_day_config
• Rate_group
  • single_value_alternative_list

Methods

בהמשך מופיעה השוואה בין השיטות ב-Content API for Shopping לבין השיטות ב-Merchant Shipping settings API:

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