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
Wenn Sie die Merchant API verwenden möchten, um Informationen zu 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 einen Beispielvergleich der Content API for Shopping mit der Ressource „Versandeinstellungen“ in der Unter-API „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 sind die wichtigsten Aktualisierungen der Ressource „Versandeinstellungen“ in der Unter-API „Konten“ im Vergleich zur Content API for Shopping aufgeführt:
- Nutzer der Merchant API müssen
accounts/{ACCOUNT_ID}/shippingSettingsin 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 mit dem 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, die 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 |
Freiformname 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, für die dieser Dienst gilt. |
service.deliveryTime.minTransitTimeInDays |
services.deliveryTime.minTransitDays |
Die Mindestanzahl von Arbeitstagen, die eine Bestellung unterwegs ist. 0 bedeutet beispielsweise Lieferung am selben Tag und 1 Lieferung am nächsten Tag. |
service.deliveryTime.maxTransitTimeInDays |
services.deliveryTime.maxTransitDays |
Die maximale Anzahl von Arbeitstagen, die eine Bestellung für den Transport benötigt. |
service.deliveryTime.minHandlingTimeInDays |
services.deliveryTime.minHandlingDays |
Die Mindestanzahl an Arbeitstagen, die vor dem Versand einer Bestellung vergehen müssen. |
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 für Bestellungen. |
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 der 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 einzelnen 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_groupservicePickup_serviceEligibilityScheduling_channelDelivery_timeHoliday_cutoffRate_groupsingle_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 |