Diese Seite wurde von der Cloud Translation API übersetzt.

Versandeinstellungen – Übersicht

Mit der Ressource shippingsettings können Sie die Versandeinstellungen Ihres Kontos abrufen und aktualisieren.

Google kann die voraussichtliche Lieferdauer für einige Produkte automatisch aktualisieren. Weitere Informationen findest du unter Automatische Verbesserungen aktivieren.

Versandeinstellungen lesen, schreiben oder aktualisieren

So verwenden Sie den Merchant API-Versandservice:

Senden Sie eine GET-Anfrage, um die vollständigen Versandeinstellungen Ihres Kontos abzurufen.
Ändern Sie die Versandeinstellungen.
Stellen Sie eine INSERT-Anfrage mit den geänderten Versandeinstellungen.

ETag

ETag ist ein codiertes Token, um asynchrone Aktualisierungen zu vermeiden. Das ETag ändert sich, wenn sich Daten zu Versandeinstellungen ändern. Nutzer müssen das ETag, das sie aus der GET-Anfrage erhalten haben, in den INSERT-Anfragetext kopieren.

Wenn sich die Daten zu den Versandeinstellungen zwischen der GET- und der INSERT-Anfrage ändern, erhalten Sie eine Fehlermeldung, in der eine weitere GET-Anfrage zum Abrufen des neuesten ETag-Tokens angefordert wird. Sie müssen die GET-Anfrage aufrufen, um das neue etag-Token abzurufen, und das neue etag-Token in den INSERT-Anfragetext kopieren.

Versandeinstellungen hinzufügen

Mit shippingsettings.insert können Sie Versandeinstellungen für Ihr Konto hinzufügen oder aktualisieren. Mit dieser Beispielanfrage wird maxTransitDays für einen Versandservice namens GSA Shipping – Free Ship Over $49,99 (Versandkostenfrei über 49,99 $) unter Konto 10 auf 7 aktualisiert.

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings/

{
  "services": [
    {
      "name": "FedEx",
      "active": true,
      "deliveryCountries": ["US"],
      "currencyCode": "USD",
      "deliveryTime": {
        "minTransitDays": 4,
        "maxTransitDays": 6,
        "minHandlingDays": 0,
        "maxHandlingDays": 0
      },
      "rateGroups": [
        {
          "singleValue": {
            "flatRate": {
              "amountMicros": 5990000,
              "currencyCode": "USD"
            }
          },
          "name": "All products"
        }
      ]
    },
    {
      "name": "GSA Shipping - Free Ship Over $49.99",
      "active": true,
      "deliveryCountries": "US",
      "currencyCode": "USD",
      "deliveryTime": {
        "minTransitDays": 3,
        "maxTransitDays": 7,
        "minHandlingDays": 1,
        "maxHandlingDays": 2
      },
      "rateGroups": [
        {
          "mainTable": {
            "rowHeaders": {
              "prices": [
                {
                  "amountMicros": 49990000,
                  "currencyCode": "USD"
                },
                {
                  "amountMicros": -1,
                  "currencyCode": "USD"
                }
              ]
            },
            "rows": [
              {
                "cells": [
                  {
                    "flatRate": {
                      "amountMicros": 6990000,
                      "currencyCode": "USD"
                    }
                  }
                ]
              },
              {
                "cells": [
                  {
                    "flatRate": {
                      "amountMicros": 0,
                      "currencyCode": "USD"
                    }
                  }
                ]
              }
            ]
          },
          "name": "Free Ship Over $49.99"
        }
      ]
    }
  ]
}

Warehouses festlegen

Das folgende JSON-Beispiel zeigt, wie Sie den Versandeinstellungsdienst des Händlers verwenden können, um Lagerinformationen für Ihr Händlerkonto zu verwalten:

"warehouses": [
  {
    "name": "warehouse 1",
    "shippingAddress": {
      "streetAddress": {street_address},
      "city": {city},
      "administrativeArea": {administrative_area},
      "postalCode": {postal_code},
      "regionCode": {region_code}
    },
    "cutoffTime": {
      "minutes": {minutes}
    },
    "handlingDays": {handling_days},
    "businessDaysConfig": {
      "businessDays": [
        "MONDAY", "SUNDAY"
      ]
    }
  }
]

Ersetzen Sie Folgendes:

{street_address}: Teil der Lageradresse auf Straßenebene.
{city}: Stadt oder Kommune, in der sich das Lager befindet.
{administrative_area}: Die Verwaltungseinheit des Landes. Zum Beispiel ein Bundesland.
{postal_code}: Die Postleitzahl.
{region_code}: Der Ländercode als String.
{minutes}: Minutenangabe des Annahmeschlusses, bis zu dem eine Bestellung aufgegeben werden muss, damit sie am selben Tag vom Lager bearbeitet werden kann.
{handling_days}: Die Anzahl der Tage, die dieses Lager benötigt, um einen Artikel zu verpacken und zu versenden.

Die Ressource warehouses ist eine Liste von Warehouses. Jedes Lager kann anhand der lagerbasierten Lieferdauer des Versandservice bis warehouse.name bezeichnet werden.

Lager verwalten

So verwalten Sie Ihre Warenlager mithilfe der Merchant API:

Stellen Sie eine GET-Anfrage, um alle vorhandenen shippingsettings und Lager abzurufen.
Kopieren Sie die shippingsettings aus der GET-Anfrage in die UPDATE-Anfrage.

Hinweis: Wenn Sie nicht alle vorhandenen shippingsettings kopieren, werden diese in der INSERT-Anfrage aus Ihrem Konto gelöscht.
Füllen Sie die Warehouses aus, wenn Sie sie im Abschnitt warehouses für die INSERT-Anfrage verwenden möchten.
Stellen Sie eine UPDATE-Anfrage, die die Ressourcen shippingsettings und warehouses enthält.

Hier ist ein Beispiel für einen INSERT-Anfragetext mit einem Warehouse für Warehouse 1, das von New York nach Mountain View aktualisiert wurde:

{
  "services": [
    {
      "name": "Standard Shipping",
      "active": true,
      "deliveryCountries": ["US", "UK"],
      "currencyCode": "USD",
      "deliveryTime": {
        "minHandlingDays": 0,
        "maxHandlingDays": 1,
        "warehouseBasedDeliveryTimes": [
{"carrier": "Fedex"
 "carrierService": "ground"
 "warehouse": "Warehouse 1"
},
{"carrier": "Fedex"
 "carrierService": "2 days"
 "warehouse": "Warehouse 2"
}
]
      },
      "rateGroups": [
        {
          "singleValue": {
            "flatRate": {
              "amountMicros": 0,
              "currencyCode": "USD"
            }
          },
          "name": "Standard Shipping"
        }
      ],
    },
    {
      "name": "Expedited",
            "flatRate": {
              "amountMicros": 9990000,
              "currencyCode": "USD"
            }
          },
          "name": "Expedited"
        }
      ],
    }
  ],
  "warehouses": [
    {
      "name": "Warehouse1",
      "shippingAddress": [
        {
        "streetAddress": "1111 shoreline street"
          "city": "Mountain View",
          "administrativeArea": "CA"
        }
      ]
    },
    {
      "name": "Warehouse 2",
      "country": "US",
      "postalCodeRanges": [
        {
        "streetAddress": "1111 5th avenue"
          "city": "New York",
          "administrativeArea": "NY"
        }
      ]
    }
  ]
}

Lieferung am selben Tag hinzufügen

Mit der Content API for Shopping können Sie Versandservices für die Lieferung am selben Tag konfigurieren, wenn Sie lokales Inventar haben. Bei Versandservices für die Lieferung am selben Tag sind local_delivery als shipment_type festgelegt. Für alle Versandservices von local_delivery gilt derzeit eine Lieferung am selben Tag.

Du kannst die delivery_time-Informationen für lokale Lieferungen nicht ändern. Mit shippingsettings.insert können Sie die Lieferung am selben Tag für Ihre Produkte mit lokalem Inventar einrichten.

Hier ist ein Beispiel für einen Anfragetext, mit dem allen Geschäften Ihres Kontos ein Lieferservice am selben Tag hinzugefügt wird:

{
  "name": "accounts/accountId/shippingSettings",
  "services": [
    {
      "name": "Local Delivery",
      "active": true,
      "shipmentType": "local_delivery",
      "deliveryCountries": "US",
      "currencyCode": "USD",
      "rateGroups": [
        {
          "singleValue": {
            "flatRate": {
              "amountMicros": 0,
              "currencyCode": "USD"
            }
          }
        }
      ],
      "storeConfig": {
        "storeServiceType": "all stores",
        "storeCodes": [],
        "cutoffConfig": {
          "storeCloseOffsetHours": 2,
          "noDeliveryPostCutoff": true
        },
        "serviceRadius": {
          "value": 4,
          "unit": "Miles"
        }
      }
    }
  ]
}

Lieferung am nächsten Tag hinzufügen

Für Bestellungen, die nach dem Annahmeschluss für Lieferungen am selben Tag eingehen, wird die Lieferung standardmäßig am nächsten Tag geplant. Wenn Sie die Lieferung am nächsten Tag deaktivieren möchten, setzen Sie das Feld no_delivery_post_cutoff auf „true“. Wenn Sie die Lieferung am nächsten Tag deaktivieren, sind Ihre Versandservices jeden Tag nur vor dem Annahmeschluss für Bestellungen sichtbar.

Die Lieferung am nächsten Tag ist nur verfügbar, wenn shipment_type den Wert local_delivery hat.