rocket
ขอแนะนำ
Merchant API
ซึ่งเป็นเวอร์ชันต่อไปอย่างเป็นทางการของ Content API for Shopping
update
รับข้อมูลล่าสุด
เกี่ยวกับฟีเจอร์ใหม่ การแก้ไขข้อบกพร่อง และการอัปเดตของ Merchant API
add_alert
หมายเหตุ: Content API for Shopping จะหยุดให้บริการในวันที่ 18 สิงหาคม 2026
สัญญาณการติดตามคําสั่งซื้อ
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
สัญญาณการติดตามคำสั่งซื้อช่วยให้คุณระบุข้อมูลการติดตามคำสั่งซื้อย้อนหลังสำหรับคำสั่งซื้อที่ดำเนินการผ่านเว็บไซต์ของผู้ขายให้ Google ได้ ซึ่งจะช่วยให้
ผู้ซื้อทราบค่าจัดส่งโดยประมาณที่แม่นยำและถูกต้องมากขึ้น สัญญาณการติดตามคำสั่งซื้อยังช่วยให้คุณปรับปรุงข้อมูลด้วยคำอธิบายประกอบการจัดส่งฟรีและรวดเร็วได้อีกด้วย
คุณส่งข้อมูลสำหรับคำสั่งซื้อที่ดำเนินการเสร็จสมบูรณ์ผ่านเว็บไซต์ของผู้ขายได้
ข้อมูลที่คุณส่งจะช่วยเสริมข้อมูลการกำหนดค่าการจัดส่งที่คุณระบุเป็นส่วนหนึ่งของการตั้งค่าบัญชี Merchant Center เช่น หากคุณระบุการประมาณการจัดส่งแก่ผู้ซื้อเป็น
3-7 วัน แต่การติดตามคำสั่งซื้อย้อนหลังล่าสุดระบุว่าคำสั่งซื้อ
มักจะนำส่งภายใน 3 วันในบางภูมิภาค Google จะอัปเดตข้อมูลของคุณเพื่อ
ให้การประมาณการที่แม่นยำยิ่งขึ้นแก่ลูกค้า
คำแนะนำนี้จะอธิบายวิธีใช้บริการ ordertrackingsignals
เพื่อส่ง
ข้อมูลการติดตามคำสั่งซื้อย้อนหลัง
ใช้บริการ ordertrackingsignals
ordertrackingsignals
บริการนี้มีcreate
ปลายทางเดียว ซึ่งช่วยให้คุณส่งข้อมูลการติดตามคำสั่งซื้อย้อนหลังได้ โปรดส่งเฉพาะข้อมูลสำหรับ
คำสั่งซื้อที่นำส่งแล้ว เพื่อให้เรายืนยันเวลาในการจัดส่งได้ คุณ
ส่งคำสั่งซื้อได้ 1 รายการต่อคำขอ คุณส่งข้อมูลต่อไปนี้ในเนื้อหาคำขอได้
ดูข้อมูลเพิ่มเติมเกี่ยวกับฟิลด์การติดตามคำสั่งซื้อที่จำเป็นและไม่บังคับได้ในเอกสารอ้างอิงสำหรับแหล่งข้อมูล
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
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-08-13 UTC
[null,null,["อัปเดตล่าสุด 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."]]