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

כדי להשתמש ב-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

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

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

	Content API	ממשק API של Merchant
כתובת 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}

ברשימה הבאה מפורטים העדכונים העיקריים ב-Merchant Shipping Settings 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 תומך בכמה מדינות למשלוח.

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

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

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

שמות של שדות שהשתנו

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

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

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

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

Content API for Shopping	ממשק API של Merchant
postal_code_group	region
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 |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 שיטות לפניכם השוואה בין השיטות ב-Content API for Shopping לבין Merchant Shipping settings API: שיטה Content API for Shopping ממשק API של Merchant customBatch כן לא get כן כן update כן לא insert לא כן getSupportedCarrier כן לא getSupportedHolidays כן לא