Wenn Sie die Merchant API zum Lesen von Informationen zu Versandeinstellungen verwenden möchten, stellen Sie folgende Anfragen:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings
Ersetzen Sie {accountId} durch die eindeutige ID Ihres Merchant Center-Kontos.
Wenn Sie die Merchant API zum Lesen von Informationen zu Versandeinstellungen verwenden möchten, stellen Sie folgende Anfragen:
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert
Vergleich zwischen Content API for Shopping und Merchant API
Hier ein Beispiel für einen Vergleich der Content API for Shopping mit der Merchant Shipping Settings API:
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 im Vergleich zur Content API for Shopping aufgeführt:
- Nutzer der Merchant API müssen
accounts/{accountId}/shippingSettings
in das Feld {name} eingeben, um dasselbe Verhalten zu erzielen. - Die Merchant API unterstützt keine Lese- und Schreibvorgänge für benutzerdefinierte Gebiete wie Standortgruppen. Benutzerdefinierte Bereiche wie Standortgruppen können nur mit dem Regionsdienst gelesen oder geschrieben werden.
- Die Einrichtung von
WarehouseBasedDeliveryTime
unterscheidet sich bei der Merchant API von der der Content API for Shopping. Wenn Sie die Merchant API verwenden, müssen Sie Lagerinformationen untershippingsettings.warehouses
definieren. Anschließend kann jeder Versandservice über den Warehouse-Namen unterwarehouseBaseDeliveryTime
auf das Lager verweisen. - Ein Dienst in der Merchant API unterstützt mehrere Lieferländer.
Neue unterstützte Felder
Die Merchant Shipping Settings API unterstützt im Vergleich zur Content API for Shopping die folgenden neuen Felder:
- Warehouses: Liefert Informationen zu einem Fulfillment-Warehouse, in dem Inventar gespeichert und verarbeitet wird.
- Treuepunkteprogramme: Merchant API-Nutzer können Informationen zu Treuepunkteprogrammen in ihren Versandeinstellungen eingeben.
- ETag: Mit ETag können asynchrone Probleme behoben werden, die auftreten, wenn verschiedene Nutzer gleichzeitig versuchen, die Versandeinstellungen über die Merchant API und die Merchant Center-UI zu aktualisieren.
Umbenannte Felder
Die folgenden Felder wurden in der Merchant API umbenannt:
Content API for Shopping | API für Versandeinstellungen des Händlers | Beschreibung |
---|---|---|
service |
services |
Ein einzelner Versandservice. |
service.name |
services.serviceName |
Kostenloser Name des Dienstes, der innerhalb Ihres Merchant Center-Kontos nur einmal vorkommen darf. |
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 Service gilt. |
service.deliveryTime.minTransitTimeInDays |
services.deliveryTime.minTransitDays |
Mindestanzahl von Arbeitstagen, die eine Bestellung auf dem Transportweg verbringt. Beispiel: 0 bedeutet eine Lieferung am selben Tag und 1 eine Lieferung am nächsten Tag. |
service.deliveryTime.maxTransitTimeInDays |
services.deliveryTime.maxTransitDays |
Maximale Anzahl von Arbeitstagen, die eine Bestellung auf dem Transportweg verbringt. |
service.deliveryTime.minHandlingTimeInDays |
services.deliveryTime.minHandlingDays |
Minimale Anzahl von Arbeitstagen, die bis zum Versand einer Bestellung benötigt werden. |
service.deliveryTime.maxHandlingTimeInDays |
services.deliveryTime.maxHandlingDays |
Maximale Anzahl von Arbeitstagen, die vor dem 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 |
Definitionen für Versandpreisgruppen. |
service.rate_group.subtable |
services.rateGroups.subtables |
Eine Liste mit untergeordneten Tabellen. |
service.rate_group.carrier_rate |
services.rateGroups.carrierRates |
Eine Liste der vom Transportunternehmen berechneten Preise. |
service.minimumOrderValueTable.storeCodeSetWithMovs |
services.minimumOrderValueTable.storeCodeSetWithMovs |
Eine Liste von Geschäftscodesätzen mit demselben Mindestbestellwert. |
Verworfene Methoden
Sie können shippingsettings.custombatch
nicht verwenden, um die Versandeinstellungen mehrerer Konten in einer einzigen Anfrage abzurufen und zu aktualisieren.
Eingestellte Felder
Die folgenden Felder wurden in der Merchant API eingestellt. Hinweis: Die Merchant API bietet keine Alternative für diese Felder.
Content API for Shopping | Händler-API | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
postal_code_group |
region |
||||||||||||||||||||
service
| MethodenHier ein Vergleich der Methoden in der Content API for Shopping und der Merchant Shipping Settings API:
|