Versandeinstellungen von der Content API for Shopping migrieren

Die ShippingSettings Ressource können Sie die Versandeinstellungen Ihres Kontos abrufen und aktualisieren in allen verknüpften Unterkonten. Weitere Informationen dazu, wie Sie Versandeinstellungen Ihres Kontos hinzufügen oder verwalten, siehe Versandübersicht Einstellungen.

Um die Merchant API zum Lesen von Informationen zu Versandeinstellungen zu nutzen, verwenden Sie Folgendes: Anfragen:

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

Ersetzen Sie {accountId} durch die eindeutige Kennung Ihres Merchant Center-Konto.

Um die Merchant API zum Lesen von Informationen zu Versandeinstellungen zu nutzen, verwenden Sie Folgendes: Anfragen:

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

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

Vergleich der Content API for Shopping und der Merchant API

Hier sehen Sie ein Beispiel für einen Vergleich zwischen der Content API for Shopping und der API für Versandeinstellungen:

	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 aufgeführt. im Vergleich zur Content API for Shopping:

1. Nutzer der Händler-API müssen accounts/{accountId}/shippingSettings in den {name} verwenden, um dasselbe Verhalten zu erreichen.
2. Die Händler-API unterstützt keine Lese- und Schreibvorgänge für benutzerdefinierte Bereiche wie als Standortgruppen. Benutzerdefinierte Bereiche wie Standortgruppen mit dem Regionsdienst geschrieben.
3. WarehouseBasedDeliveryTime einrichten für die Merchant API von der Content API for Shopping. Wenn Sie die Merchant API verwenden, müssen Sie Lagerinformationen unter shippingsettings.warehouses Dann kann jeder Versandservice auf die Lager über den Lagernamen unter warehouseBaseDeliveryTime.
4. Ein Service in der Merchant API unterstützt mehrere Lieferländer.

Neue unterstützte Felder

Die Merchant Shipping Settings API unterstützt im Vergleich zu Content API for Shopping:

1. Warehouses: stellt Informationen zu einem Lager für die Auftragsabwicklung bereit, in der das Inventar gespeichert und verwaltet wird.
2. Treuepunkteprogramme: Nutzer der Merchant API können Informationen zum Treuepunkteprogramm in die Versandeinstellungen ändern.
3. ETag: ETag wurde entwickelt, um asynchrone Probleme zu lösen, wenn verschiedene Nutzer versuchen, Aktualisieren Sie die Versandeinstellungen über die Merchant API und die Merchant Center-Benutzeroberfläche auf der .

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	Name der Dienstleistung in freiem Format, der in Ihrem Merchant Center-Konto eindeutig sein muss.
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 Dienst gilt.
service.deliveryTime.minTransitTimeInDays	services.deliveryTime.minTransitDays	Mindestanzahl von Arbeitstagen, die eine Bestellung auf dem Transportweg verbringt. 0 bedeutet beispielsweise eine Lieferung am selben Tag und 1 die Lieferung am nächsten Tag.
service.deliveryTime.maxTransitTimeInDays	services.deliveryTime.maxTransitDays	Maximale Anzahl von Werktagen, die eine Bestellung auf dem Transportweg verbringt.
service.deliveryTime.minHandlingTimeInDays	services.deliveryTime.minHandlingDays	Mindestanzahl von Arbeitstagen, die bis zum Versand einer Bestellung benötigt werden.
service.deliveryTime.maxHandlingTimeInDays	services.deliveryTime.maxHandlingDays	Maximale Anzahl von Werktagen, die bis zum 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	Gruppendefinitionen für Versandkosten.
service.rate_group.subtable	services.rateGroups.subtables	Eine Liste untergeordneter Tabellen.
service.rate_group.carrier_rate	services.rateGroups.carrierRates	Eine Liste der vom Transportunternehmen berechneten Preise.
service.minimumOrderValueTable.storeCodeSetWithMovs	services.minimumOrderValueTable.storeCodeSetWithMovs	Eine Liste mit Geschäftscodes mit demselben Mindestbestellwert.

Verworfene Methoden

Sie können shippingsettings.custombatch nicht zum Abrufen und die Versandeinstellungen mehrerer Konten in einer Anfrage aktualisieren.

Eingestellte Felder

Die folgenden Felder der Content API wurden in der Merchant API eingestellt. Händler Die 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 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