產品運送時間是指訂單成立後,預估送達所需的時間。運送信號 合作夥伴可以使用這項 功能,代表合作商家為特定區域設定運送時間。
運送信號合作夥伴可以使用這項資源,為商品/區域組合設定運送時間,並代表連結的商家查看或刪除現有的運送時間。一個 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
如要取得產品的運送時間,請使用商家的 merchantId
和 productId
呼叫 get
。這個方法會傳回指定 productId
的 ProductDeliveryTime
執行個體。
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime/productId
刪除
運送信號合作夥伴可以呼叫 delete
,並提供商家 merchantId
和 productId
,即可刪除產品的運送時間。這個方法會傳回空白的回應。
DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime/productId