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

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

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

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

שיטות

לפניכם השוואה בין השיטות ב-Content API for Shopping Merchant Shipping settings API:

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