نقل إدارة إشارات تتبُّع الطلبات

تتيح لك إشارات تتبُّع الطلبات تزويد Google ببيانات تتبُّع الطلبات السابقة التي تم إكمالها من خلال موقع التاجر الإلكتروني. ويوفّر ذلك للمشترين تقديرات أكثر دقة للشحن.

مقارنةً بـ Content API، لا توجد تغييرات كبيرة في واجهة برمجة التطبيقات الخاصة بإشارات تتبُّع الطلبات.

لقد أزلنا الحقول التي أوقفناها نهائيًا في السابق. وتشمل هذه الأغراض ما يلي:

• upc
• sku
• product_description

بالإضافة إلى ذلك، أضفنا حقلاً:

• الوالد: accounts/{account}

هذا يعني أنّ واجهة برمجة التطبيقات تشير الآن إلى حساب بدلاً من تاجر.

الطلبات

عنوان URL لطلب بيانات من Content API مثل ما يلي:

https://shoppingcontent.googleapis.com/content/v2.1/{ACCOUNT_ID}/ordertrackingsignals

في ما يلي نموذج ردّ على طلب بيانات من Content API:

{
  "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"
}

في ما يلي نموذج طلب في Merchant API:

https://merchantapi.googleapis.com/products/ordertracking/v1/accounts/{ACCOUNT_ID}/ordertrackingsignals

يظهر نموذج الردّ على طلب بيانات من Merchant API على النحو التالي:

{
  "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"
}