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:
- משתמשי Merchant API חייבים להזין
accounts/{accountId}/shippingSettings
אל {name} בשדה התנהגות זהה. - Merchant API לא תומך בפעולות קריאה וכתיבה באזורים מותאמים אישית, כמו בתור קבוצות לפי מיקום. ניתן לקרוא רק אזורים מותאמים אישית, כמו קבוצות לפי מיקום, או שנכתבו באמצעות שירות האזור.
- אופן ההגדרה של
WarehouseBasedDeliveryTime
הוא שונה ב-Merchant API בהשוואה ל-Content API for Shopping. אם משתמשים ב-Merchant API, צריך להגדיר פרטי מחסן תוךshippingsettings.warehouses
כל שירות משלוחים יכול להפנות מחסן דרך שם המחסן עדwarehouseBaseDeliveryTime
. - שירות אחד ב-Merchant API תומך בכמה מדינות למשלוחים.
שדות נתמכים חדשים
בממשק ה-API של הגדרות המשלוח למוכר יש תמיכה בשדות החדשים הבאים בהשוואה Content API for Shopping:
- מחסנים: מספק מידע על מחסן לאספקה, שמאחסן ומטפל במלאי.
- מועדוני לקוחות: משתמשי Merchant API יכולים להזין פרטים על מועדון הלקוחות כדי בהגדרות המשלוח שלהם.
- 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 |
כן | לא |