انتقال مدیریت نشان‌های رهگیری سفارش

سیگنال‌های پیگیری سفارش به شما امکان می‌دهد داده‌های پیگیری سفارش‌های قبلی‌تان را که ازطریق سایت فروشنده تکمیل شده است به Google ارائه دهید. این کار باعث می‌شود خریداران برآوردهای دقیق‌تر و صحیح‌تری از ارسال دریافت کنند.

درمقایسه با Content API، تغییرات عمده‌ای در API سیگنال‌های پیگیری سفارش وجود ندارد.

فیلدهایی را که قبلاً منسوخ کرده بودیم برداشته‌ایم. این موارد عبارت‌اند از

• upc
• sku
• product_description

علاوه‌براین، فیلدی اضافه کرده‌ایم:

• ولی: accounts/{account}

این یعنی API اکنون به‌جای فروشنده به حساب ارجاع می‌دهد.

درخواست‌ها

نشانی وب درخواست 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"
}