Versandeinstellungen von der Content API for Shopping migrieren

Über die 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 Übersicht über die Versandeinstellungen.

Wenn Sie mit der Merchant API Informationen zu Versandeinstellungen abrufen möchten, verwenden Sie die folgenden Anfragen:

GET https://merchantapi.googleapis.com/accounts/v1beta/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 Versandeinstellungen zu aktualisieren, verwenden Sie die folgenden Anfragen:

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

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

Content API for Shopping und Merchant API im Vergleich

Hier ist ein Beispiel für einen Vergleich der Content API for Shopping mit der API für Versandeinstellungen für Händler:

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

In der folgenden Liste sind die wichtigsten Änderungen an der Merchant Shipping Settings API im Vergleich zur Content API for Shopping aufgeführt:

1. Merchant API-Nutzer müssen accounts/{ACCOUNT_ID}/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 Bereiche 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 Content API for Shopping. Wenn Sie die Merchant API verwenden, müssen Sie unter shippingsettings.warehouses Informationen zum Lager definieren. Anschließend kann jeder Versandservice unter warehouseBaseDeliveryTime auf das Lager durch den Lagernamen verweisen.
4. Ein Dienst in der Merchant API unterstützt mehrere Lieferländer.

Neue unterstützte Felder

Die API für Versandeinstellungen von Händlern unterstützt im Vergleich zur Content API for Shopping die folgenden neuen Felder:

1. Lagerhäuser: Hier finden Sie Informationen zu einem Fulfillment-Lager, in dem Inventar gelagert und verarbeitet wird.
2. Treuepunkteprogramme: Merchant API-Nutzer können Informationen zu Treuepunkteprogrammen in ihre Versandeinstellungen eingeben.
3. Etag: Mit Etag können Probleme behoben werden, die auftreten, wenn verschiedene Nutzer gleichzeitig versuchen, die Versandeinstellungen über die Merchant API und die Merchant Center-Benutzeroberfläche zu aktualisieren.

Umbenannte Felder

Die folgenden Felder wurden in der Merchant API umbenannt:

Content API for Shopping	Merchant Shipping settings API	Beschreibung
service	services	Ein einzelner Versandservice.
service.name	services.serviceName	Kostenlos wählbarer 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	Mindestanzahl von Arbeitstagen, die eine Bestellung für den Versand benötigt. 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	Mindestanzahl von Arbeitstagen, die vergehen, bevor eine Bestellung versendet wird.
service.deliveryTime.maxHandlingTimeInDays	services.deliveryTime.maxHandlingDays	Die maximale Anzahl von Arbeitstagen, die vergehen, bis eine Bestellung versandt 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 von Versandkostenpauschalengruppen
service.rate_group.subtable	services.rateGroups.subtables	Eine Liste von untergeordneten Tabellen.
service.rate_group.carrier_rate	services.rateGroups.carrierRates	Eine Liste der Mobilfunkanbieterpreise.
service.minimumOrderValueTable.storeCodeSetWithMovs	services.minimumOrderValueTable.storeCodeSetWithMovs	Eine Liste von Sets mit Geschäftscodes mit demselben Mindestbestellwert.

Eingestellte Methoden

Mit shippingsettings.custombatch können Sie die Versandeinstellungen mehrerer Konten nicht in einer einzigen Anfrage abrufen und aktualisieren.

Verworfene Felder

Die folgenden Felder aus der Content API sind in der Merchant API nicht mehr verfügbar. Die Merchant API bietet keine Alternative für diese Felder.

• postal_code_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 ist ein Vergleich der Methoden in der Content API for Shopping und der Merchant Shipping Settings API:

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