הגדרת זמן אספקה של מוצרים

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

חשוב: מוֹכרים לא יכולים לערוך את ProductDeliveryTime ישירות. השיטות create ו-delete מחזירות שגיאה אם השולח הוא מוכר ולא שותף של אותות משלוח.

שותפים שמשתמשים באותות משלוח יכולים להשתמש במשאב הזה כדי להגדיר זמני אספקה לצמדים של אזורים ומוצרים, וכדי להציג או למחוק זמני אספקה קיימים בשם מוֹכרים שמקושרים אליהם. משאב אחד של ProductDeliveryTime מכיל כמה זמני משלוח, ויכול להיות רק מופע אחד של ProductDeliveryTime לכל מבצע.

כדי להשתמש במשאב ProductDeliveryTime, צריך לבצע אימות בתור חשבון Merchant Center שלכם, ולא בתור חשבון המוכר שאתם מעדכנים.

create

שותפים ששולחים אותות משלוח יכולים ליצור או לעדכן את זמן אספקת המוצר באמצעות קריאה ל-create עם merchantIdשל חשבון המוכר לעדכון ועם מופע ProductDeliveryTime. כדי לעדכן את זמן האספקה של מוצר קיים, צריך לספק את כל השדות ProductDeliveryTime, כולל אלה שלא השתנו. כל בקשת create מחליפה את המופע הקודם, כך ששדות שלא כללתם יאבדו. השיטה הזו מחזירה את המופע ProductDeliveryTime עם המידע המעודכן ששלחתם.

כל ProductDeliveryTime יכול להכיל עד 100 רשומות של areaDeliveryTimes.

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime

הנה דוגמה לגוף הבקשה:

{
  "productId": {
    "productId": "online:en:US:offer-id"
  }
  "areaDeliveryTimes": [
    {
      "deliveryArea": {
        "countryCode": "US"
        "postalCodeRange": {
          "firstPostalCode": "123*"
          "lastPostalCode": "456*"
        }
      }
      "deliveryTime": {
        "minHandlingTimeDays": "0"
        "maxHandlingTimeDays": "1"
        "minTransitTimeDays": "2"
        "maxTransitTimeDays": "4"
      }
    },
    {
      "deliveryArea": {
        "countryCode": "US"
        "administrativeAreaCode": "NY"
      }
      "deliveryTime": {
        "minHandlingTimeDays": "0"
        "maxHandlingTimeDays": "1"
        "minTransitTimeDays": "5"
        "maxTransitTimeDays": "7"
      }
    }
  ]
}

get

כדי לקבל את זמן האספקה של מוצר, צריך להפעיל את get עם merchantId של המוכר ועם productId. השיטה הזו מחזירה את מופע ProductDeliveryTime של productId שצוין.

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime/productId

delete

שותפים שמשתמשים באותות משלוח יכולים למחוק את זמן האספקה של מוצר מסוים על ידי קריאה אל delete עם merchantId של המוכר ועם productId. השיטה הזו מחזירה תגובה ריקה.

DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime/productId