Versandeinstellungen – Übersicht

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:

  1. Stellen Sie eine GET-Anfrage, um die vollständigen Versandeinstellungen Ihrer Konto.
  2. Ändern Sie die Versandeinstellungen.
  3. 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:

  1. Stellen Sie eine GET-Anfrage, um alle Ihre vorhandenen shippingsettings und Lagerhallen.
  2. Kopieren Sie die shippingsettings aus der GET-Anfrage in die UPDATE-Anfrage.

  3. Füllen Sie die Warehouses aus, wenn Sie sie im Abschnitt warehouses verwenden möchten für die INSERT-Anfrage.

  4. Stellen Sie eine UPDATE-Anfrage, die shippingsettings und warehouses 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.