借助订单跟踪信号，您可以向 Google 提供通过商家网站完成的订单的历史订单跟踪数据。这样，买家就能获得更精确的送货预估时间。借助订单跟踪信号，您还可以使用“免费快速配送”注释来完善商品详情。
您可以提交通过商家网站完成的订单的数据。 您提交的数据与您在 Merchant Center 账号设置过程中提供的配送配置信息相辅相成。例如，如果您向买家提供 3 至 7 天的预计送货时间，但近期的订单跟踪历史记录表明，您的订单在某些地区通常会在 3 天内送达，Google 就可以更新您的商品详情，为客户提供更精确的预计送货时间。
本指南介绍了如何使用 ordertrackingsignals 服务提交历史订单跟踪数据。
使用 ordertrackingsignals 服务
ordertrackingsignals 服务包含一个 create 端点，您可以通过该端点提交历史订单跟踪数据。请仅提交已送达订单的数据，以便我们验证送货时间。每个请求只能提交一个订单。在请求正文中，您可以提交以下信息：
- 订单信息，包括订单 ID、订单创建时间、送货邮政编码和地区代码
- 向买家收取的运费 (
customer_shipping_fee) - 配送信息 (
shippingInfo)，包括订单所关联的每个运单的运输公司、跟踪信息、发货地、目的地和配送时间 - 订单项信息 (
lineItems)，包括订单中的商品 - 订单项与订单配送信息的映射 (
shipment_line_item_mapping) 您要为其提交数据的商家的商家 ID (
merchant_id)。此字段为可选字段，可让您代表其他商家提供数据。如果您未为此字段提供值，则数据会与提交数据的账号相关联。
如需详细了解必需和可选订单跟踪字段，请参阅 ordertrackingsignals 资源的参考文档。
提交新的订单跟踪信号数据
以下是提交新订单跟踪数据的请求示例：
https://shoppingcontent.googleapis.com/content/v2.1/merchantId/ordertrackingsignals
{
"merchantId": "987654321",
"orderCreatedTime": {
"year": 2020,
"month": 1,
"day": 2,
"hours": 0,
"minutes": 0,
"seconds": 0,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"orderId": "123456789",
"shippingInfo": [
{
"shipmentId": "1",
"trackingId": "100",
"carrierName": "FEDEX",
"carrierServiceName": "GROUND",
"shippedTime": {
"year": 2020,
"month": 1,
"day": 3,
"hours": 0,
"minutes": 0,
"seconds": 0,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"shippingStatus": "DELIVERED"
},
{
"shipmentId": "2",
"earliestDeliveryPromiseTime": {
"year": 2020,
"month": 1,
"day": 4,
"hours": 0,
"minutes": 0,
"seconds": 0,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"latestDeliveryPromiseTime": {
"year": 2020,
"month": 1,
"day": 5,
"hours": 0,
"minutes": 0,
"seconds": 0,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"actualDeliveryTime": {
"year": 2020,
"month": 1,
"day": 5,
"hours": 0,
"minutes": 0,
"seconds": 0,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"shippedTime": {
"year": 2020,
"month": 1,
"day": 3,
"hours": 0,
"minutes": 0,
"seconds": 0,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"shippingStatus": "DELIVERED"
}
],
"lineItems": [
{
"lineItemId": "item1",
"productId": "online:en:US:item1",
"quantity": "3"
},
{
"lineItemId": "item2",
"productId": "online:en:US:item2",
"quantity": "5"
}
],
"shipmentLineItemMapping": [
{
"shipmentId": "1",
"lineItemId": "item1",
"quantity": "1"
},
{
"shipmentId": "2",
"lineItemId": "item1",
"quantity": "2"
},
{
"shipmentId": "1",
"lineItemId": "item2",
"quantity": "4"
},
{
"shipmentId": "2",
"lineItemId": "item2",
"quantity": "1"
}
],
"customerShippingFee": {
"value": "4.5",
"currency": "USD"
},
"deliveryPostalCode": "94043",
"deliveryRegionCode": "US"
}
更新现有订单跟踪信号数据
如需修改已提交的订单跟踪数据，请提交包含相同 orderId 的新数据的请求。为了提供配送时间估算值以及快速免费的徽章，系统只会使用每个 orderId 的最新提交数据。