Mit dem Dienst für lokales Inventar können Sie Instanzen der Ressource für lokales Inventar erstellen und aktualisieren. Diese enthält Felder, die für verschiedene physische Geschäftsstandorte unterschiedliche Werte haben können. Jede Instanz für lokales Inventar ist ein untergeordnetes Element einer vorhandenen Produktressource und erbt die Produktdatenfelder von der übergeordneten Ressource. Ein Produkt kann beispielsweise in verschiedenen Geschäften einen unterschiedlichen Preis und eine unterschiedliche Menge haben, aber in allen Geschäften dieselbe ID, Beschreibung und andere Produktdaten. Daten zum lokalen Inventar werden für die Programme Lokale Google-Plattformen und Anzeigen für lokales Inventar verwendet.
In diesem Leitfaden erfahren Sie, was Sie benötigen, bevor Sie den Dienst für lokales Inventar verwenden können. Außerdem werden die verfügbaren Felder und Methoden beschrieben und ein Beispiel für eine Serviceanfrage bereitgestellt.
, um zusätzliche lokale Produktaktualisierungen vorzunehmen.Vorbereitung
- 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 die Geschäftscodes für Ihr Unternehmensprofil einrichten.
Ihr Merchant Center-Konto muss für ein lokales Programm registriert sein, entweder für Lokale Plattformen auf Google oder für 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.
Mit dem Dienst für lokales Inventar werden Instanzen für lokales Inventar für vorhandene lokale Produkte erstellt. Sie müssen zuerst lokale Produkte erstellen. Verwenden Sie dazu entweder den Content API-Dienst products oder Merchant Center-Feeds. Legen Sie das Feld
channelauflocalfest. Anschließend können Sie mit dem Dienst für lokales Inventar Instanzen für lokales Inventar für jedes Unternehmensprofilstorecodeerstellen, 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 Unternehmensstandort verknüpft sind. Nur storecode und productId sind für alle Anfragen erforderlich. Alle anderen Felder sind optional:
- Für alle Anfragen erforderlich:
storeCode,productId(in der URL) - Optional:
quantity,price,salePrice,salePriceEffectiveDate,availability,pickupMethod,pickupSla,instoreProductLocation
Eine vollständige Liste der Felder für lokales Inventar und ihrer Beschreibungen finden Sie auf der Referenzseite localinventory.
Methoden
Der Dienst für lokales Inventar umfasst nur zwei Methoden:
localinventory.insert
localinventory.insert
ermöglicht es Ihnen, eine Instanz für lokales Inventar für ein einzelnes lokales Produkt zu erstellen.
In diesem Beispiel wird gezeigt, wie Sie den Dienst für lokales Inventar verwenden, um ein Angebot im Geschäft vom 24. Februar 2021 um 13:00 Uhr (GMT-8) bis zum 28. Februar 2021 um 15:30 Uhr (GMT-8) zu erstellen. Mit der Anfrage wird auch die für die Instanz des lokalen Inventars verfügbare Menge aktualisiert. Im Gegensatz zu Subfeeds für nicht lokale Produktdaten werden Felder, die nicht im Hauptteil 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
localinventory.custombatch
ermöglicht es Ihnen, mehrere Instanzen für lokales Inventar für ein einzelnes lokal erhältliches Produkt in mehreren Geschäften oder Instanzen für lokales Inventar für mehrere lokal erhältliche Produkte zu erstellen.