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

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

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

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

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

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

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

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

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

הנה השוואה לדוגמה בין Content API for Shopping לבין מקור המידע על הגדרות המשלוח ב-Accounts sub-API:

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

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

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

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

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

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

שדות ששמם שונה

השמות של השדות הבאים שונו במשאב הגדרות המשלוח ב-Accounts sub-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 לבין המשאב Shipping settings:

שיטה Content API for Shopping Merchant API
customBatch כן לא
get כן כן
update כן לא
insert לא כן
list כן לא
getSupportedCarrier כן לא
getSupportedHolidays כן לא
הקודם
Migrate data sources management
הבא
Migrate conversion sources management