商品配送时间是指从下单到订单送达所需的大致时间。启用运费信号的合作伙伴可以使用此功能代表合作商家为特定地区设置送达时间。
配送信号合作伙伴可以使用此资源为商品-地区对设置送货时长,并代表与其关联的商家查看或删除现有送货时长。一个 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
,获取商品的送货时长。此方法会返回给定 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