Dienst für lokales Inventar

Mit dem lokalen Inventardienst können Sie Instanzen der lokalen Inventarressource erstellen und aktualisieren. Diese Felder enthalten Felder mit unterschiedlichen Werten für verschiedene Geschäftsstandorte. Jede Instanz für lokales Inventar ist einer vorhandenen Produktressource untergeordnet und übernimmt die Produktdatenfelder von der übergeordneten Ressource. Beispiel: Sie haben ein Produkt, das in verschiedenen Geschäften unterschiedliche Preise und Mengen hat, aber in allen Geschäften dieselbe ID, eine Beschreibung und andere Produktdaten hat. Daten zu lokalem Inventar werden für die Programme Plattformen für lokales Inventar auf Google und Anzeigen für lokales Inventar verwendet.

In diesem Leitfaden werden die Voraussetzungen für die Nutzung des Dienstes für lokales Inventar, die verfügbaren Felder und Methoden sowie ein Beispiel für eine Dienstleistungsanfrage beschrieben.

Voraussetzungen

  • Wenn Sie den Dienst für lokales Inventar nutzen möchten, müssen Sie ein Unternehmensprofil erstellen, Ihr Unternehmensprofil mit Ihrem Merchant Center-Konto verknüpfen, Ihr Unternehmen bestätigen und Ihre Unternehmensprofil-Geschäftscodes einrichten.

  • Ihr Merchant Center-Konto muss für ein lokales Programm angemeldet sein: entweder Plattformen für lokales Inventar auf Google oder Anzeigen für lokales Inventar. Weitere Informationen zur Verwendung von Anzeigen für lokales Inventar über die Content API finden Sie unter Erste Schritte mit Anzeigen für lokales Inventar.

  • Der Dienst für lokales Inventar erstellt Instanzen für lokales Inventar für vorhandene lokale Produkte. Sie müssen zuerst lokal erhältliche Produkte erstellen. Verwenden Sie dazu entweder den Produktdienst der Content API oder die Datenfeeds im Merchant Center, indem Sie das Feld channel auf local setzen. Anschließend kannst du den Dienst für lokales Inventar nutzen, um für jedes Unternehmensprofil storecode, in dem das Produkt verkauft wird, Instanzen für lokales Inventar zu erstellen.

Felder

Jede Instanz für lokales Inventar enthält eine Reihe von Feldern, die über das Feld storeCode (das Sie in Ihrem Unternehmensprofil definieren) mit einem bestimmten Geschäftsstandort verknüpft sind. Für alle Anfragen sind nur storecode und productId erforderlich. Alle anderen Felder sind optional:

  • Erforderlich für alle Anfragen: storeCode, productId (in URL)
  • Optional: quantity, price, salePrice, salePriceEffectiveDate, availability, pickupMethod, pickupSla, instoreProductLocation

Eine vollständige Liste der Felder für lokales Inventar und ihre Beschreibungen finden Sie auf der Referenzseite für localinventory.

Methoden

Der lokale Inventardienst umfasst nur zwei Methoden:

localinventory.insert

Mit localinventory.insert können Sie eine Instanz für lokales Inventar für ein einzelnes lokales Produkt erstellen.

In diesem Beispiel wird gezeigt, wie Sie mit dem Dienst für lokales Inventar vom 24. Februar 2021 um 13:00 Uhr GMT-8 bis zum 28. Februar 2021 um 15:30 Uhr (GMT-8) ein Angebot im Geschäft erstellen. Mit der Anfrage wird auch die verfügbare Menge für die Instanz für lokales Inventar aktualisiert. Im Gegensatz zu Subfeeds für nicht lokale Produktdaten werden Felder, die nicht im Text der Anfrage enthalten sind, durch diesen Aufruf überschrieben:

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId/localinventory

{
  "storeCode": “1235”,
  "salePrice": {
     "value": “100.00”,
     "currency": “USD”
   },
  "salePriceEffectiveDate": “2021-02-24T13:00-0800/2021-02-28T15:30-0800”,
  "quantity": 200,
}

localinventory.custombatch

Mit localinventory.custombatch kannst du mehrere Instanzen für lokales Inventar für ein einzelnes lokales Produkt in mehreren Geschäften oder Instanzen für lokales Inventar für mehrere lokal erhältliche Produkte erstellen.