Mit der 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 Versandeinstellungen.
Wenn Sie die Merchant API verwenden möchten, um Informationen zu den Versandeinstellungen abzurufen, verwenden Sie die folgenden Anfragen:
GET https://merchantapi.googleapis.com/accounts/v1/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 den Versandeinstellungen zu aktualisieren, verwenden Sie die folgenden Anfragen:
POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings:insert
Weitere Informationen finden Sie unter Methode:
accounts.shippingSettings.insert
.
Vergleich zwischen Content API for Shopping und Merchant API
Hier sehen Sie ein Beispiel für einen Vergleich der Content API for Shopping mit der Ressource für Versandeinstellungen in der Unter-API für 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 finden Sie die wichtigsten Aktualisierungen der Ressource „Versandeinstellungen“ in der Unter-API „Konten“ im Vergleich zur Content API for Shopping:
- Nutzer der Merchant API müssen
accounts/{ACCOUNT_ID}/shippingSettings
in das Feld {NAME} einfügen, 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 über den 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 Methode shippingsettings.list in der Content API.
Neue unterstützte Felder
Die Ressource „Versandeinstellungen“ in der Unter-API „Accounts“ unterstützt im Vergleich zur Content API for Shopping die folgenden neuen Felder:
warehouses
: Enthält Informationen zu einem Fulfillment-Lager, in dem Inventar gelagert und bearbeitet wird.- 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 über die Merchant API und die 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 |
Kostenlos formulierter 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 |
Die Mindestanzahl von Werktagen, 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 |
Maximale Anzahl von Werktagen, die eine Bestellung unterwegs ist. |
service.deliveryTime.minHandlingTimeInDays |
services.deliveryTime.minHandlingDays |
Die Mindestanzahl an Arbeitstagen, die vergehen, bevor eine Bestellung versendet wird. |
service.deliveryTime.maxHandlingTimeInDays |
services.deliveryTime.maxHandlingDays |
Maximale Anzahl von Arbeitstagen, die vor dem Versand einer Bestellung vergehen. |
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 Postleitzahlgruppe. |
service.deliveryTime.transitTimeTable.transitTimeLabel |
services.deliveryTime.transitTimeTable.transitTimeLabel |
Das Laufzeitlabel des Produkts. |
service.rate_group |
services.rateGroups |
Definitionen von Versandkostengruppen. |
service.rate_group.subtable |
services.rateGroups.subtables |
Eine Liste mit Untertabellen. |
service.rate_group.carrier_rate |
services.rateGroups.carrierRates |
Eine Liste der Mobilfunkanbietergebühren. |
service.minimumOrderValueTable.storeCodeSetWithMovs |
services.minimumOrderValueTable.storeCodeSetWithMovs |
Eine Liste von Store-Code-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 werden in der Merchant API entfernt. Für diese Felder gibt es in der Merchant API keine Alternative.
postal_code_group
service
Pickup_service
Eligibility
Scheduling_channel
Delivery_time
Holiday_cutoff
Rate_group
single_value_alternative_list
Methoden
Hier sehen Sie einen Vergleich der Methoden in der Content API for Shopping und der Ressource für Versandeinstellungen:
Methode | Content API for Shopping | Merchant API |
---|---|---|
customBatch |
Ja | Nein |
get |
Ja | Ja |
update |
Ja | Nein |
insert |
Nein | Ja |
list |
Ja | Nein |
getSupportedCarrier |
Ja | Nein |
getSupportedHolidays |
Ja | Nein |