Mit dem lokalen Inventardienst können Sie Instanzen der lokalen Inventarressource erstellen und aktualisieren, die Felder enthalten, die unterschiedliche Werte für verschiedene Geschäftsstandorte haben können. 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 haben. Lokale Inventardaten werden für die Programme Plattformen für lokales Inventar auf Google und Anzeigen für lokales Inventar verwendet.
In diesem Leitfaden wird erläutert, was Sie benötigen, bevor Sie den Dienst für lokales Inventar verwenden. Außerdem werden die verfügbaren Felder und Methoden beschrieben und es wird ein Beispiel für eine Dienstanfrage gegeben.
Voraussetzungen
- Wenn Sie den lokalen Inventardienst nutzen möchten, müssen Sie ein Unternehmensprofil erstellen, Ihr Unternehmensprofil mit Ihrem Merchant Center-Konto verknüpfen, Ihr Unternehmen bestätigen und die Geschäftscodes für Ihr Unternehmensprofil einrichten.
Ihr Merchant Center-Konto muss für ein lokales Programm registriert 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.
local
Der Dienst für lokales Inventar erstellt Instanzen mit lokalem Inventar für vorhandene lokal erhältliche Produkte. Sie müssen zuerst lokale Produkte erstellen. Dazu verwenden Sie entweder den Content API-Dienst Produkte oder Merchant Center-Datenfeeds. Setzen Sie dazu das Feld
channel
auflocal
. Anschließend können Sie mit dem lokalen Inventardienst Instanzen für lokales Inventar für jedes Unternehmensprofil-storecode
erstellen, in dem das Produkt verkauft wird.
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:
- Für alle Anfragen erforderlich:
storeCode
,productId
(in URL) - Optional:
quantity
,price
,salePrice
,salePriceEffectiveDate
,availability
,pickupMethod
,pickupSla
,instoreProductLocation
Eine vollständige Liste der Felder für lokales Inventar und deren Beschreibungen finden Sie auf der Referenzseite für lokales Inventar.
Methoden
Der Dienst für lokales Inventar 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 für die Instanz mit lokalem Inventar verfügbare Menge 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
können Sie mehrere Instanzen mit lokalem Inventar für ein einzelnes lokales Produkt in mehreren Geschäften oder Instanzen für lokales Inventar für mehrere lokale Produkte erstellen.