Die
ShippingSettings
Ressource können Sie die Versandeinstellungen Ihres Kontos abrufen und aktualisieren.
Google kann die voraussichtliche Lieferdauer für einige Produkte automatisch aktualisieren. Weitere Informationen finden Sie unter Automatische .
Versandeinstellungen lesen, schreiben oder aktualisieren
So nutzen Sie den Merchant API-Versandservice:
- Stellen Sie eine
GET
-Anfrage, um die vollständigen Versandeinstellungen Ihrer Konto. - Ändern Sie die Versandeinstellungen.
- Stellen Sie eine
INSERT
-Anfrage mit den geänderten Versandeinstellungen.
ETag
ETag ist ein codiertes Token, um asynchrone Aktualisierungen zu vermeiden. Das ETag ändert sich, wenn
alle Änderungen an den Versandeinstellungen. Nutzer müssen das ETag kopieren, das sie
aus der GET
-Anfrage an den INSERT
-Anfragetext abgerufen.
Wenn sich die Daten zu den Versandeinstellungen zwischen der GET
-Anfrage und der INSERT
ändern
-Anfrage erhalten Sie eine Fehlermeldung, mit der Sie eine weitere GET
-Anfrage an
und rufen Sie das neueste ETag-Token ab. Du musst die GET
-Anfrage anrufen, um
Rufen Sie das neue etag-Token ab und kopieren Sie das neue etag-Token in die INSERT
-Anfrage
Textkörper.
Versandeinstellungen hinzufügen
Verwenden Sie shippingsettings.insert
, um die Versandeinstellungen für Ihr
Konto. Hier sehen Sie eine Beispielanfrage, mit der maxTransitDays
für eine
Versandservice namens GSA Shipping - Free Ship over $49.99 (registriert)
10.
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings/
{
"services": [
{
"name": "FedEx",
"active": true,
"deliveryCountries": ["US"],
"currencyCode": "USD",
"deliveryTime": {
"minTransitDays": 4,
"maxTransitDays": 6,
"minHandlingDays": 0,
"maxHandlingDays": 0
},
"rateGroups": [
{
"singleValue": {
"flatRate": {
"amountMicros": 5990000,
"currencyCode": "USD"
}
},
"name": "All products"
}
]
},
{
"name": "GSA Shipping - Free Ship Over $49.99",
"active": true,
"deliveryCountries": "US",
"currencyCode": "USD",
"deliveryTime": {
"minTransitDays": 3,
"maxTransitDays": 7,
"minHandlingDays": 1,
"maxHandlingDays": 2
},
"rateGroups": [
{
"mainTable": {
"rowHeaders": {
"prices": [
{
"amountMicros": 49990000,
"currencyCode": "USD"
},
{
"amountMicros": -1,
"currencyCode": "USD"
}
]
},
"rows": [
{
"cells": [
{
"flatRate": {
"amountMicros": 6990000,
"currencyCode": "USD"
}
}
]
},
{
"cells": [
{
"flatRate": {
"amountMicros": 0,
"currencyCode": "USD"
}
}
]
}
]
},
"name": "Free Ship Over $49.99"
}
]
}
]
}
Warehouses festlegen
Im folgenden JSON-Beispiel sehen Sie, wie Sie die Versandeinstellungen des Händlers verwenden können. Dienst zur Verwaltung von Lagerinformationen für Ihr Händlerkonto:
"warehouses": [
{
"name": "warehouse 1",
"shippingAddress": {
"streetAddress": {street_address},
"city": {city},
"administrativeArea": {administrative_area},
"postalCode": {postal_code},
"regionCode": {region_code}
},
"cutoffTime": {
"minutes": {minutes}
},
"handlingDays": {handling_days},
"businessDaysConfig": {
"businessDays": [
"MONDAY", "SUNDAY"
]
}
}
]
Ersetzen Sie Folgendes:
- {street_address}: Teil der Lageradresse auf Straßenebene.
- {city}: Stadt, Gemeinde oder Gemeinde, in der sich das Lager befindet.
- {administrative_area}: die administrative Unterteilung der Land. Zum Beispiel ein Bundesland.
- {postal_code}: Die Postleitzahl.
- {region_code}: Ländercode im String
- {minutes}: Minutenabschnitt des Annahmeschlusses, bis zu dem ein Bestellung muss noch am selben Tag im Lager bearbeitet werden.
- {handling_days}: Anzahl der Tage, die hierfür benötigt werden um einen Artikel zu verpacken und zu versenden.
Die Ressource warehouses
ist eine Liste von Warehouses. Jedes Lager kann
auf die lagerspezifische Lieferdauer des Versandservices
warehouse.name
Lager verwalten
So verwalten Sie Ihre Warenlager mit der Merchant API:
- Stellen Sie eine
GET
-Anfrage, um alle Ihre vorhandenenshippingsettings
und Lagerhallen. Kopieren Sie die
shippingsettings
aus derGET
-Anfrage in dieUPDATE
-Anfrage.Füllen Sie die Warehouses aus, wenn Sie sie im Abschnitt
warehouses
verwenden möchten für dieINSERT
-Anfrage.Stellen Sie eine
UPDATE
-Anfrage, dieshippingsettings
undwarehouses
enthält Ressourcen.
Beispiel für einen INSERT
-Anfragetext mit dem aktualisierten Warehouse für Warehouse 1
von New York nach Mountain View:
{
"services": [
{
"name": "Standard Shipping",
"active": true,
"deliveryCountries": ["US", "UK"],
"currencyCode": "USD",
"deliveryTime": {
"minHandlingDays": 0,
"maxHandlingDays": 1,
"warehouseBasedDeliveryTimes": [
{"carrier": "Fedex"
"carrierService": "ground"
"warehouse": "Warehouse 1"
},
{"carrier": "Fedex"
"carrierService": "2 days"
"warehouse": "Warehouse 2"
}
]
},
"rateGroups": [
{
"singleValue": {
"flatRate": {
"amountMicros": 0,
"currencyCode": "USD"
}
},
"name": "Standard Shipping"
}
],
},
{
"name": "Expedited",
"flatRate": {
"amountMicros": 9990000,
"currencyCode": "USD"
}
},
"name": "Expedited"
}
],
}
],
"warehouses": [
{
"name": "Warehouse1",
"shippingAddress": [
{
"streetAddress": "1111 shoreline street"
"city": "Mountain View",
"administrativeArea": "CA"
}
]
},
{
"name": "Warehouse 2",
"country": "US",
"postalCodeRanges": [
{
"streetAddress": "1111 5th avenue"
"city": "New York",
"administrativeArea": "NY"
}
]
}
]
}
Lieferung am selben Tag hinzufügen
Sie können die Content API for Shopping verwenden, um die Lieferung am selben Tag zu konfigurieren
Dienstleistungen, wenn Sie lokales Inventar haben. Versandservices für die Lieferung am selben Tag
local_delivery
als shipment_type
. Gesamter Versand (local_delivery
)
Dienstleistungen werden derzeit als Lieferungen am selben Tag betrachtet.
Sie können die delivery_time
-Informationen für lokale Lieferungen nicht ändern. Verwenden Sie
shippingsettings.insert
, um für Ihr lokales Inventar die Lieferung am selben Tag einzurichten
zu verbessern.
Hier sehen Sie einen Beispielanfragetext, mit dem allen Geschäften ein Lieferservice für Lieferungen am selben Tag hinzugefügt wird für Ihr Konto:
{
"name": "accounts/accountId/shippingSettings",
"services": [
{
"name": "Local Delivery",
"active": true,
"shipmentType": "local_delivery",
"deliveryCountries": "US",
"currencyCode": "USD",
"rateGroups": [
{
"singleValue": {
"flatRate": {
"amountMicros": 0,
"currencyCode": "USD"
}
}
}
],
"storeConfig": {
"storeServiceType": "all stores",
"storeCodes": [],
"cutoffConfig": {
"storeCloseOffsetHours": 2,
"noDeliveryPostCutoff": true
},
"serviceRadius": {
"value": 4,
"unit": "Miles"
}
}
}
]
}
Lieferung am nächsten Tag hinzufügen
Bestellungen, die nach dem Annahmeschluss für die Lieferung am selben Tag aufgegeben werden, werden für den nächsten
Lieferung innerhalb eines Tages standardmäßig. Um die Lieferung am nächsten Tag zu deaktivieren, legen Sie das
no_delivery_post_cutoff
auf „true“ gesetzt. Wenn Sie die Lieferung am nächsten Tag deaktivieren,
Versandservices sind jeden Tag nur vor dem Annahmeschluss sichtbar.
Eine Lieferung am nächsten Tag ist nur möglich, wenn shipment_type
local_delivery
.
Weitere Informationen
Weitere Informationen zur Migration von der Content API for Shopping Einstellungen verwalten.