Versandeinstellungen von der Content API for Shopping migrieren

Wenn Sie die Merchant API zum Lesen von Informationen zu Versandeinstellungen verwenden möchten, stellen Sie folgende Anfragen:

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

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

Wenn Sie die Merchant API zum Lesen von Informationen zu Versandeinstellungen verwenden möchten, stellen Sie folgende Anfragen:

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

Vergleich zwischen Content API for Shopping und Merchant API

Hier ein Beispiel für einen Vergleich der Content API for Shopping mit der Merchant Shipping Settings API:

	Content API	Händler-API
URL	https://shoppingcontent.googleapis.com/content/v2.1/{accountId}/shippingsettings:insert	https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert
IDs	{accountId}/shippingsettings/{accountId}	{name}

In der folgenden Liste werden die wichtigsten Aktualisierungen der Merchant Shipping Settings API im Vergleich zur Content API for Shopping aufgeführt:

1. Nutzer der Merchant API müssen accounts/{accountId}/shippingSettings in das Feld {name} eingeben, um dasselbe Verhalten zu erzielen.
2. Die Merchant API unterstützt keine Lese- und Schreibvorgänge für benutzerdefinierte Gebiete wie Standortgruppen. Benutzerdefinierte Bereiche wie Standortgruppen können nur mit dem Regionsdienst gelesen oder geschrieben werden.
3. Die Einrichtung von WarehouseBasedDeliveryTime unterscheidet sich bei der Merchant API von der der Content API for Shopping. Wenn Sie die Merchant API verwenden, müssen Sie Lagerinformationen unter shippingsettings.warehouses definieren. Anschließend kann jeder Versandservice über den Warehouse-Namen unter warehouseBaseDeliveryTime auf das Lager verweisen.
4. Ein Dienst in der Merchant API unterstützt mehrere Lieferländer.

Neue unterstützte Felder

Die Merchant Shipping Settings API unterstützt im Vergleich zur Content API for Shopping die folgenden neuen Felder:

1. Warehouses: Liefert Informationen zu einem Fulfillment-Warehouse, in dem Inventar gespeichert und verarbeitet wird.
2. Treuepunkteprogramme: Merchant API-Nutzer können Informationen zu Treuepunkteprogrammen in ihren Versandeinstellungen eingeben.
3. ETag: Mit ETag können asynchrone Probleme behoben werden, die auftreten, wenn verschiedene Nutzer gleichzeitig versuchen, die Versandeinstellungen über die Merchant API und die Merchant Center-UI zu aktualisieren.

Umbenannte Felder

Die folgenden Felder wurden in der Merchant API umbenannt:

Content API for Shopping	API für Versandeinstellungen des Händlers	Beschreibung
service	services	Ein einzelner Versandservice.
service.name	services.serviceName	Kostenloser Name des Dienstes, der innerhalb Ihres Merchant Center-Kontos nur einmal vorkommen darf.
service.deliveryCountry	services.deliveryCountries	Der CLDR-Gebietscode des Landes, für das der Versandservice gilt.
service.currency	services.currencyCode	Der CLDR-Code der Währung, für die dieser Service gilt.
service.deliveryTime.minTransitTimeInDays	services.deliveryTime.minTransitDays	Mindestanzahl von Arbeitstagen, die eine Bestellung auf dem Transportweg verbringt. Beispiel: 0 bedeutet eine Lieferung am selben Tag und 1 eine Lieferung am nächsten Tag.
service.deliveryTime.maxTransitTimeInDays	services.deliveryTime.maxTransitDays	Maximale Anzahl von Arbeitstagen, die eine Bestellung auf dem Transportweg verbringt.
service.deliveryTime.minHandlingTimeInDays	services.deliveryTime.minHandlingDays	Minimale Anzahl von Arbeitstagen, die bis zum Versand einer Bestellung benötigt werden.
service.deliveryTime.maxHandlingTimeInDays	services.deliveryTime.maxHandlingDays	Maximale Anzahl von Arbeitstagen, die vor dem Versand einer Bestellung benötigt werden.
service.deliveryTime.cutoffTime.timezone	services.deliveryTime.cutoffTime.timeZone	Zeitzonenkennung 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 für Versandpreisgruppen.
service.rate_group.subtable	services.rateGroups.subtables	Eine Liste mit untergeordneten Tabellen.
service.rate_group.carrier_rate	services.rateGroups.carrierRates	Eine Liste der vom Transportunternehmen berechneten Preise.
service.minimumOrderValueTable.storeCodeSetWithMovs	services.minimumOrderValueTable.storeCodeSetWithMovs	Eine Liste von Geschäftscodesätzen mit demselben Mindestbestellwert.

Verworfene Methoden

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

Eingestellte Felder

Die folgenden Felder wurden in der Merchant API eingestellt. Hinweis: Die Merchant API bietet keine Alternative für diese Felder.

Content API for Shopping	Händler-API
postal_code_group	region
service Pickup_service Eligibility Scheduling_channel Delivery_time Holiday_cutoff Min_scheduling_time_in_days Max_scheduling_time_in_days Scheduling_business_day_config Rate_group |service: Pickup_service – Eligibility – Scheduling_channel – Delivery_time – Holiday_cutoff – Min_scheduling_time_in_days – Max_scheduling_time_in_days – Scheduling_business_day_config – Rate_group – single_value_alternative_list Methoden Hier ein Vergleich der Methoden in der Content API for Shopping und der Merchant Shipping Settings API: Methode Content API for Shopping Händler-API customBatch Ja Nein get Ja Ja update Ja Nein insert Nein Ja getSupportedCarrier Ja Nein getSupportedHolidays Ja Nein