產品運送時間是指訂單下單後,從訂購商品送達的預估時間。運送信號合作夥伴可以使用此功能,代表合作商家為特定區域設定運送時間。
運送信號合作夥伴可以使用這項資源設定優惠/區域組合的運送時間,並代表他們連結的商家查看或刪除現有的運送時間。一個 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
,藉此刪除產品的運送時間。這個方法會傳回空白的回應。
DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime/productId