Verwaltung von Signalen für die Bestellverfolgung migrieren

Mit Signalen zur Sendungsverfolgung können Sie Google Ihre bisherigen Daten zur Sendungsverfolgung für Bestellungen zur Verfügung stellen, die über die Website eines Händlers abgeschlossen wurden. So erhalten Käufer genauere und präzisere Versandinformationen.

Im Vergleich zur Content API, gibt es keine größeren Änderungen an der API für Signale zur Sendungsverfolgung.

Wir haben Felder entfernt, die wir zuvor verworfen haben. Dazu gehören:

• upc
• sku
• product_description

Außerdem haben wir ein Feld hinzugefügt:

• Übergeordnet: accounts/{account}

Das bedeutet, dass die API jetzt auf ein Konto und nicht mehr auf einen Händler verweist.

Anfragen

Eine Content API-Anfrage-URL wie die folgende:

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

Die Beispielantwort auf eine Content API-Anfrage sieht so aus:

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

Das folgende Beispiel zeigt eine Anfrage in der Merchant API:

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

Die Beispielantwort auf eine Merchant API-Anfrage sieht so aus:

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