設定產品運送時間

產品運送時間是指訂單下單後,從訂購商品送達的預估時間。運送信號合作夥伴可以使用此功能,代表合作商家為特定區域設定運送時間。

運送信號合作夥伴可以使用這項資源設定優惠/區域組合的運送時間,並代表他們連結的商家查看或刪除現有的運送時間。一個 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

使用商家的 merchantIdproductId 呼叫 get,取得產品的運送時間。這個方法會傳回指定 productIdProductDeliveryTime 例項。

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

delete

運送信號合作夥伴可以使用商家的 merchantIdproductId 呼叫 delete,藉此刪除產品的運送時間。這個方法會傳回空白的回應。

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