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:
- Nutzer der Händler-API müssen
accounts/{accountId}/shippingSettings
in den {name} verwenden, um dasselbe Verhalten zu erreichen. - 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.
WarehouseBasedDeliveryTime
einrichten für die Merchant API von der Content API for Shopping. Wenn Sie die Merchant API verwenden, müssen Sie Lagerinformationen untershippingsettings.warehouses
Dann kann jeder Versandservice auf die Lager über den Lagernamen unterwarehouseBaseDeliveryTime
.- 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:
- Warehouses: stellt Informationen zu einem Lager für die Auftragsabwicklung bereit, in der das Inventar gespeichert und verwaltet wird.
- Treuepunkteprogramme: Nutzer der Merchant API können Informationen zum Treuepunkteprogramm in die Versandeinstellungen ändern.
- 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 |