Die Merchant API v1beta wurde am 28. Februar 2026 eingestellt. Eine Anleitung zur Umstellung auf die aktuelle stabile Version finden Sie unter Von v1beta zu v1 migrieren.

Versandeinstellungen von der Content API for Shopping migrieren

Die ShippingSettings Ressource ermöglicht es Ihnen, die Versandeinstellungen Ihres Kontos und aller zugehörigen Unterkonten abzurufen und zu aktualisieren. Weitere Informationen zum Hinzufügen oder Verwalten der Versandeinstellungen Ihres Kontos finden Sie unter Übersicht über Versandeinstellungen.

Verwenden Sie die folgenden Anfragen, um Informationen zu den Versandeinstellungen mit der Merchant API zu lesen:

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

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

Verwenden Sie die folgenden Anfragen, um Informationen zu den Versandeinstellungen mit der Merchant API zu aktualisieren:

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

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

Vergleich zwischen der Content API for Shopping und der Merchant API

Hier ist ein Beispiel für einen Vergleich der Content API for Shopping mit der Ressource „Versandeinstellungen“ in der Unter-API „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 sind die wichtigsten Aktualisierungen der Ressource „Versandeinstellungen“ in der Unter-API „Konten“ im Vergleich zur Content API for Shopping aufgeführt:

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

Neue unterstützte Felder

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

warehouses: Enthält Informationen zu einem Fulfillment-Lager, in dem Lagerbestände aufbewahrt und bearbeitet werden.
Treuepunkteprogramme: Merchant API-Nutzer können Informationen zu Treuepunkteprogrammen in ihre Versandeinstellungen eingeben.
Etag: Etag wurde entwickelt, um asynchrone Probleme zu beheben, wenn verschiedene Nutzer gleichzeitig versuchen, Versandeinstellungen mit der Merchant API und der 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`	Freiformname des Dienstes, der in Ihrem Merchant Center-Konto eindeutig sein muss.
`service.deliveryCountry`	`services.deliveryCountries`	Der CLDR-Code der Region oder des Landes, für die der Versandservice gilt.
`service.currency`	`services.currencyCode`	Der CLDR-Code der Währung, für die dieser Dienst gilt.
`service.deliveryTime.minTransitTimeInDays`	`services.deliveryTime.minTransitDays`	Mindestanzahl von Arbeitstagen, 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`	Höchstanzahl von Arbeitstagen, die eine Bestellung unterwegs ist.
`service.deliveryTime.minHandlingTimeInDays`	`services.deliveryTime.minHandlingDays`	Mindestanzahl von Arbeitstagen, die vergehen, bevor eine Bestellung versendet wird.
`service.deliveryTime.maxHandlingTimeInDays`	`services.deliveryTime.maxHandlingDays`	Höchstanzahl von Arbeitstagen, die vergehen, bevor eine Bestellung versendet wird.
`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 Postleitzahlengruppe.
`service.deliveryTime.transitTimeTable.transitTimeLabel`	`services.deliveryTime.transitTimeTable.transitTimeLabel`	Das Laufzeitlabel des Produkts.
`service.rate_group`	`services.rateGroups`	Definitionen der Versandkostengruppen.
`service.rate_group.subtable`	`services.rateGroups.subtables`	Eine Liste von Untertabellen.
`service.rate_group.carrier_rate`	`services.rateGroups.carrierRates`	Eine Liste von Versandkostenpauschalen.
`service.minimumOrderValueTable.storeCodeSetWithMovs`	`services.minimumOrderValueTable.storeCodeSetWithMovs`	Eine Liste von Shopcode-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 wurden in der Merchant API entfernt. Die Merchant API bietet keine Alternative für diese Felder.