商品送货时长是指订单下达后预计送达所需的时间。配送信号 合作伙伴可以使用此 功能,代表与其合作的商家为特定地区设置送货时长。
配送信号合作伙伴可以使用此资源为商品/地区对设置送货时长,以及代表与其关联的商家查看或删除现有送货时长。一个
ProductDeliveryTime资源存储
多个送货时长,并且每个商品只能有一个ProductDeliveryTime
实例。
如需使用 ProductDeliveryTime 资源,请以您自己的 Merchant Center 账号(而非您要更新的商家账号)的身份进行身份验证。
create
配送信号合作伙伴可以通过
使用要更新的商家账号的
merchantId和ProductDeliveryTime
实例
调用 create 来创建或更新商品送货时长。如需更新现有商品送货时长,请确保您提供所有 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