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

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

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

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

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

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

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

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

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

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

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

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

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

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

המשאב Shipping settings ב-API המשני של חשבונות תומך בשדות החדשים הבאים בהשוואה ל-Content API for Shopping:

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

שדות ששינו את השם

השמות של השדות הבאים שונו במשאב 'הגדרות משלוח' ב-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	רשימה של קבוצות של קודי חנויות שיש להן אותו ערך הזמנה מינימלי.

שיטות שהוסרו

אי אפשר להשתמש ב-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 לבין המשאב 'הגדרות משלוח':

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