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