Versandeinstellungen von der Content API for Shopping migrieren

Mit der Ressource ShippingSettings können Sie die Versandeinstellungen Ihres Kontos und aller zugehörigen Unterkonten abrufen und aktualisieren. Weitere Informationen zum Hinzufügen oder Verwalten der Versandeinstellungen Ihres Kontos finden Sie unter Versandeinstellungen.

Wenn Sie die Merchant API verwenden möchten, um Informationen zu den Versandeinstellungen abzurufen, verwenden Sie die folgenden Anfragen:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings

Ersetzen Sie {ACCOUNT_ID} durch die eindeutige Kennung Ihres Merchant Center-Kontos.

Wenn Sie die Merchant API verwenden möchten, um Informationen zu den Versandeinstellungen zu aktualisieren, verwenden Sie die folgenden Anfragen:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings:insert

Weitere Informationen finden Sie unter Methode: accounts.shippingSettings.insert.

Vergleich zwischen Content API for Shopping und Merchant API

Hier sehen Sie ein Beispiel für einen Vergleich der Content API for Shopping mit der Ressource für Versandeinstellungen in der Unter-API für Konten:

Content API Merchant API
URL https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/shippingsettings/{ACCOUNT_ID} https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings:insert
IDs {MERCHANT_ID}/shippingsettings/{ACCOUNT_ID} {NAME}

In der folgenden Liste finden Sie die wichtigsten Aktualisierungen der Ressource „Versandeinstellungen“ in der Unter-API „Konten“ im Vergleich zur Content API for Shopping:

  1. Nutzer der Merchant API müssen accounts/{ACCOUNT_ID}/shippingSettings in das Feld {NAME} einfügen, um dasselbe Verhalten zu erzielen.
  2. Die Merchant API unterstützt keine Lese- und Schreibvorgänge für benutzerdefinierte Bereiche wie Standortgruppen. Benutzerdefinierte Bereiche wie Standortgruppen können nur über den Regionsdienst gelesen oder geschrieben werden.
  3. Ein Dienst in der Merchant API unterstützt mehrere Lieferländer.
  4. Die Merchant API bietet keine Listenmethode für Versandeinstellungen, anders als die Methode shippingsettings.list in der Content API.

Neue unterstützte Felder

Die Ressource „Versandeinstellungen“ in der Unter-API „Accounts“ unterstützt im Vergleich zur Content API for Shopping die folgenden neuen Felder:

  1. warehouses: Enthält Informationen zu einem Fulfillment-Lager, in dem Inventar gelagert und bearbeitet wird.
  2. Treuepunkteprogramme: Merchant API-Nutzer können Informationen zu Treuepunkteprogrammen in ihre Versandeinstellungen eingeben.
  3. Etag: Etag wurde entwickelt, um asynchrone Probleme zu beheben, wenn verschiedene Nutzer gleichzeitig versuchen, Versandeinstellungen über die Merchant API und die Merchant Center-Benutzeroberfläche zu aktualisieren.

Umbenannte Felder

Die folgenden Felder wurden in der Ressource „Versandeinstellungen“ in der Unter-API „Konten“ umbenannt:

Content API for Shopping Ressource „Versandeinstellungen“ Beschreibung
service services Ein einzelner Versandservice.
service.name services.serviceName Kostenlos formulierter Name des Dienstes, der innerhalb Ihres Merchant Center-Kontos eindeutig sein muss.
service.deliveryCountry services.deliveryCountries Der CLDR-Regionalcode des Landes, für das der Versandservice gilt.
service.currency services.currencyCode Der CLDR-Code der Währung, auf die sich dieser Dienst bezieht.
service.deliveryTime.minTransitTimeInDays services.deliveryTime.minTransitDays Die Mindestanzahl von Werktagen, die eine Bestellung unterwegs ist. Beispiel: 0 bedeutet Lieferung am selben Tag und 1 bedeutet Lieferung am nächsten Tag.
service.deliveryTime.maxTransitTimeInDays services.deliveryTime.maxTransitDays Maximale Anzahl von Werktagen, die eine Bestellung unterwegs ist.
service.deliveryTime.minHandlingTimeInDays services.deliveryTime.minHandlingDays Die Mindestanzahl an Arbeitstagen, die vergehen, bevor eine Bestellung versendet wird.
service.deliveryTime.maxHandlingTimeInDays services.deliveryTime.maxHandlingDays Maximale Anzahl von Arbeitstagen, die vor dem Versand einer Bestellung vergehen.
service.deliveryTime.cutoffTime.timezone services.deliveryTime.cutoffTime.timeZone Zeitzonen-ID für den Annahmeschluss.
service.deliveryTime.transitTimeTable.postalCodeGroupName services.deliveryTime.transitTimeTable.postalCodeGroupNames Der Name der Postleitzahlgruppe.
service.deliveryTime.transitTimeTable.transitTimeLabel services.deliveryTime.transitTimeTable.transitTimeLabel Das Laufzeitlabel des Produkts.
service.rate_group services.rateGroups Definitionen von Versandkostengruppen.
service.rate_group.subtable services.rateGroups.subtables Eine Liste mit Untertabellen.
service.rate_group.carrier_rate services.rateGroups.carrierRates Eine Liste der Mobilfunkanbietergebühren.
service.minimumOrderValueTable.storeCodeSetWithMovs services.minimumOrderValueTable.storeCodeSetWithMovs Eine Liste von Store-Code-Sets mit demselben Mindestbestellwert.

Entfernte Methoden

Sie können shippingsettings.custombatch nicht verwenden, um die Versandeinstellungen mehrerer Konten in einer einzigen Anfrage abzurufen und zu aktualisieren.

Entfernte Felder

Die folgenden Felder aus der Content API for Shopping werden in der Merchant API entfernt. Für diese Felder gibt es in der Merchant API keine Alternative.

  • postal_code_group
  • service
    • Pickup_service
    • Eligibility
    • Scheduling_channel
    • Delivery_time
      • Holiday_cutoff

    • Rate_group
      • single_value_alternative_list

Methoden

Hier sehen Sie einen Vergleich der Methoden in der Content API for Shopping und der Ressource für Versandeinstellungen:

Methode Content API for Shopping Merchant API
customBatch Ja Nein
get Ja Ja
update Ja Nein
insert Nein Ja
list Ja Nein
getSupportedCarrier Ja Nein
getSupportedHolidays Ja Nein