rocket
Giới thiệu
Merchant API – API chính thức thay thế cho Content API for Shopping.
add_alert
Lưu ý: Content API for Shopping sẽ ngừng hoạt động từ ngày 18 tháng 8 năm 2026.
Tín hiệu theo dõi đơn đặt hàng
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tín hiệu theo dõi đơn đặt hàng cho phép bạn cung cấp cho Google dữ liệu theo dõi đơn đặt hàng trước đây của những đơn đặt hàng đã hoàn tất thông qua trang web của người bán. Điều này giúp người mua nhận được thông tin ước tính chính xác hơn về phí vận chuyển. Các tín hiệu theo dõi đơn đặt hàng cũng giúp bạn cải thiện trang thông tin bằng chú thích về dịch vụ vận chuyển nhanh và miễn phí.
Bạn có thể gửi dữ liệu cho những đơn đặt hàng đã hoàn tất thông qua trang web của người bán.
Dữ liệu mà bạn gửi sẽ bổ sung cho thông tin cấu hình thông tin vận chuyển mà bạn cung cấp trong quá trình thiết lập tài khoản Merchant Center. Ví dụ: nếu bạn cung cấp cho người mua thông tin ước tính về thời gian vận chuyển là 3-7 ngày, nhưng dữ liệu theo dõi đơn đặt hàng gần đây cho thấy đơn đặt hàng của bạn thường đến sau 3 ngày ở một số khu vực, thì Google có thể cập nhật trang thông tin của bạn để cung cấp cho khách hàng thông tin ước tính chính xác hơn.
Hướng dẫn này giải thích cách sử dụng dịch vụ ordertrackingsignals để gửi dữ liệu theo dõi đơn đặt hàng trước đây.
Sử dụng dịch vụ ordertrackingsignals
Dịch vụ ordertrackingsignals bao gồm một điểm cuối create duy nhất, cho phép bạn gửi dữ liệu theo dõi đơn đặt hàng trước đây. Chỉ gửi dữ liệu cho những đơn đặt hàng đã được giao để chúng tôi có thể xác minh thời gian vận chuyển. Bạn có thể gửi một đơn đặt hàng cho mỗi yêu cầu. Trong phần nội dung yêu cầu, bạn có thể gửi những thông tin sau:
Để biết thêm thông tin về các trường theo dõi đơn đặt hàng bắt buộc và không bắt buộc, hãy xem tài liệu tham khảo về tài nguyên ordertrackingsignals.
Gửi dữ liệu tín hiệu theo dõi đơn đặt hàng mới
Sau đây là yêu cầu mẫu để gửi dữ liệu theo dõi đơn đặt hàng mới:
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"
}
Cập nhật dữ liệu tín hiệu theo dõi đơn đặt hàng hiện có
Để sửa đổi dữ liệu theo dõi đơn đặt hàng đã gửi, hãy gửi một yêu cầu chứa dữ liệu mới có cùng orderId. Đối với thông tin ước tính về thời gian vận chuyển và huy hiệu vận chuyển nhanh và miễn phí, hệ thống chỉ sử dụng dữ liệu được gửi gần đây nhất cho mỗi orderId.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-13 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-13 UTC."],[[["\u003cp\u003eThe Merchant API is the new version of the Content API for Shopping and improves integration.\u003c/p\u003e\n"],["\u003cp\u003eOrder tracking signals allow providing Google with historical order tracking data for more accurate shipping estimates and free and fast shipping annotations.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eordertrackingsignals\u003c/code\u003e service enables submitting historical order tracking data for completed orders to enhance shipping estimates.\u003c/p\u003e\n"],["\u003cp\u003eData submission includes order details, shipping costs, carrier information, and line item details.\u003c/p\u003e\n"],["\u003cp\u003eData can be updated by submitting a new request with the same \u003ccode\u003eorderId\u003c/code\u003e, with the most recent data used for shipping estimates.\u003c/p\u003e\n"]]],["The Merchant API's beta version is introduced, alongside the `ordertrackingsignals` service. This service allows merchants to submit historical order tracking data via the `create` endpoint. Submitted data includes order details, shipping costs, shipping information, line items, and shipment mappings. This improves shipping estimates and enables free and fast shipping annotations on listings. Merchants can update data by resubmitting with the same `orderId`. Only delivered orders should be submitted.\n"],null,["# Order tracking signals let you provide Google with your historical order\ntracking data for orders completed through a merchant's site. This provides\nbuyers more precise and accurate shipping estimates. Order tracking signals\nalso let you enhance your listings with [free and fast shipping\nannotations](//support.google.com/merchants/answer/9780562).\n\nYou can submit data for orders completed through a merchant's site.\nThe data that you submit compliments the shipping\nconfiguration information that you provide as part of your Merchant Center\naccount setup. For example, if you provide buyers with shipping estimates of\n3-7 days, but your recent historical order tracking indicates that your orders\ntypically arrive in 3 days in some regions, Google can update your listings to\nprovide customers with a more precise estimate.\n\nThis guide explains how to use the `ordertrackingsignals` service to submit your\nhistorical order tracking data.\n\nUse the `ordertrackingsignals` service\n--------------------------------------\n\nThe `ordertrackingsignals` service includes a single `create` endpoint, which\nallows you to submit your historical order tracking data. Only submit data for\norders that have been delivered, so that we can verify shipping times. You can\nsubmit one order per request. In the request body you can submit the following\ninformation:\n\n- Order information, including the order ID and the order creation time, delivery postal code, and region code\n- Shipping cost charged to the buyer (`customer_shipping_fee`)\n- Shipping information (`shippingInfo`) including the carrier, tracking, origin, destination, and shipping times for each shipment associated with the order\n- Order line item information (`lineItems`), including the products in the order\n- A mapping of the order line items to order shipments (`shipment_line_item_mapping`)\n- The merchant ID of the merchant for which you are submitting data\n (`merchant_id`). This field is optional and allows you to provide data on behalf\n of another merchant. If you do not provide a value for this field, the data is\n associated with the account that submits it.\n\n | **Note:** You must be enabled before you can submit data on behalf of another merchant. To request access, contact us at [OrderTrackingSignals@google.com](mailto:OrderTrackingSignals@google.com).\n\nFor more information on required and optional order tracking fields, see the\nreference documentation for the\n[`ordertrackingsignals`](/shopping-content/reference/rest/v2.1/ordertrackingsignals)\nresource.\n\n### Submit new order tracking signals data\n\nHere's a sample request to submit new order tracking data: \n\n https://shoppingcontent.googleapis.com/content/v2.1/\u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003emerchantId\u003c/span\u003e\u003c/var\u003e/ordertrackingsignals\n\n {\n \"merchantId\": \"987654321\",\n \"orderCreatedTime\": {\n \"year\": 2020,\n \"month\": 1,\n \"day\": 2,\n \"hours\": 0,\n \"minutes\": 0,\n \"seconds\": 0,\n \"timeZone\": {\n \"id\": \"America/Los_Angeles\"\n }\n },\n \"orderId\": \"123456789\",\n \"shippingInfo\": [\n {\n \"shipmentId\": \"1\",\n \"trackingId\": \"100\",\n \"carrierName\": \"FEDEX\",\n \"carrierServiceName\": \"GROUND\",\n \"shippedTime\": {\n \"year\": 2020,\n \"month\": 1,\n \"day\": 3,\n \"hours\": 0,\n \"minutes\": 0,\n \"seconds\": 0,\n \"timeZone\": {\n \"id\": \"America/Los_Angeles\"\n }\n },\n \"shippingStatus\": \"DELIVERED\"\n },\n {\n \"shipmentId\": \"2\",\n \"earliestDeliveryPromiseTime\": {\n \"year\": 2020,\n \"month\": 1,\n \"day\": 4,\n \"hours\": 0,\n \"minutes\": 0,\n \"seconds\": 0,\n \"timeZone\": {\n \"id\": \"America/Los_Angeles\"\n }\n },\n \"latestDeliveryPromiseTime\": {\n \"year\": 2020,\n \"month\": 1,\n \"day\": 5,\n \"hours\": 0,\n \"minutes\": 0,\n \"seconds\": 0,\n \"timeZone\": {\n \"id\": \"America/Los_Angeles\"\n }\n },\n \"actualDeliveryTime\": {\n \"year\": 2020,\n \"month\": 1,\n \"day\": 5,\n \"hours\": 0,\n \"minutes\": 0,\n \"seconds\": 0,\n \"timeZone\": {\n \"id\": \"America/Los_Angeles\"\n }\n },\n \"shippedTime\": {\n \"year\": 2020,\n \"month\": 1,\n \"day\": 3,\n \"hours\": 0,\n \"minutes\": 0,\n \"seconds\": 0,\n \"timeZone\": {\n \"id\": \"America/Los_Angeles\"\n }\n },\n \"shippingStatus\": \"DELIVERED\"\n }\n ],\n \"lineItems\": [\n {\n \"lineItemId\": \"item1\",\n \"productId\": \"online:en:US:item1\",\n \"quantity\": \"3\"\n },\n {\n \"lineItemId\": \"item2\",\n \"productId\": \"online:en:US:item2\",\n \"quantity\": \"5\"\n }\n ],\n \"shipmentLineItemMapping\": [\n {\n \"shipmentId\": \"1\",\n \"lineItemId\": \"item1\",\n \"quantity\": \"1\"\n },\n {\n \"shipmentId\": \"2\",\n \"lineItemId\": \"item1\",\n \"quantity\": \"2\"\n },\n {\n \"shipmentId\": \"1\",\n \"lineItemId\": \"item2\",\n \"quantity\": \"4\"\n },\n {\n \"shipmentId\": \"2\",\n \"lineItemId\": \"item2\",\n \"quantity\": \"1\"\n }\n ],\n \"customerShippingFee\": {\n \"value\": \"4.5\",\n \"currency\": \"USD\"\n },\n \"deliveryPostalCode\": \"94043\",\n \"deliveryRegionCode\": \"US\"\n }\n\n### Update existing order tracking signals data\n\nTo modify already submitted order tracking data, submit a request that contains\nnew data with the same `orderId`. For shipping estimates and fast and free\nbadging, only the most recently submitted data for each `orderId` is used."]]
