Package google.shopping.merchant.inventories.v1beta

Index

LocalInventoryService

Dienst zum Verwalten des lokalen Inventars für Produkte

DeleteLocalInventory

rpc DeleteLocalInventory(DeleteLocalInventoryRequest) returns (Empty)

Löscht die angegebene LocalInventory aus dem angegebenen Produkt in Ihrem Händlerkonto. Es kann bis zu einer Stunde dauern, bis die LocalInventory aus dem jeweiligen Produkt gelöscht wird. Warten Sie nach Erhalt einer erfolgreichen Antwort auf das Löschen diese Zeitspanne ab, bevor Sie einen weiteren Löschversuch starten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

InsertLocalInventory

rpc InsertLocalInventory(InsertLocalInventoryRequest) returns (LocalInventory)

Fügen Sie einem Produkt in Ihrem Händlerkonto eine LocalInventory-Ressource hinzu.

Ersetzt die vollständige LocalInventory-Ressource, wenn für das Produkt bereits ein Eintrag mit derselben storeCode vorhanden ist.

Es kann bis zu 30 Minuten dauern, bis die neue oder aktualisierte LocalInventory-Ressource in den Produkten angezeigt wird.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

ListLocalInventories

rpc ListLocalInventories(ListLocalInventoriesRequest) returns (ListLocalInventoriesResponse)

Hier werden die LocalInventory-Ressourcen für das betreffende Produkt in Ihrem Händlerkonto aufgeführt. Die Antwort enthält möglicherweise weniger Elemente als in pageSize angegeben. Wenn pageToken in einer vorherigen Anfrage zurückgegeben wurde, kann es verwendet werden, um weitere Ergebnisse zu erhalten.

LocalInventory Ressourcen werden pro Produkt für ein bestimmtes Konto aufgeführt.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

RegionalInventoryService

Dienst zum Verwalten des regionalen Inventars für Produkte. Es gibt auch eine separate regions-Ressource und API zum Verwalten von Regionsdefinitionen.

DeleteRegionalInventory

rpc DeleteRegionalInventory(DeleteRegionalInventoryRequest) returns (Empty)

Löscht die angegebene RegionalInventory-Ressource aus dem angegebenen Produkt in Ihrem Händlerkonto. Es kann bis zu einer Stunde dauern, bis die RegionalInventory aus dem jeweiligen Produkt gelöscht wird. Warten Sie nach Erhalt einer erfolgreichen Antwort auf das Löschen diese Zeitspanne ab, bevor Sie einen weiteren Löschversuch starten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

InsertRegionalInventory

rpc InsertRegionalInventory(InsertRegionalInventoryRequest) returns (RegionalInventory)

Fügen Sie einem bestimmten Produkt in Ihrem Händlerkonto ein RegionalInventory hinzu.

Ersetzt die vollständige RegionalInventory-Ressource, wenn für das Produkt bereits ein Eintrag mit derselben region vorhanden ist.

Es kann bis zu 30 Minuten dauern, bis die neue oder aktualisierte RegionalInventory-Ressource in den Produkten angezeigt wird.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

ListRegionalInventories

rpc ListRegionalInventories(ListRegionalInventoriesRequest) returns (ListRegionalInventoriesResponse)

Hier werden die RegionalInventory-Ressourcen für das betreffende Produkt in Ihrem Händlerkonto aufgeführt. Die Antwort enthält möglicherweise weniger Elemente als in pageSize angegeben. Wenn pageToken in einer vorherigen Anfrage zurückgegeben wurde, kann es verwendet werden, um weitere Ergebnisse zu erhalten.

RegionalInventory Ressourcen werden pro Produkt für ein bestimmtes Konto aufgeführt.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

DeleteLocalInventoryRequest

Anfragenachricht für die Methode DeleteLocalInventory.

Felder
name

string

Erforderlich. Der Name des lokalen Inventars für das betreffende Produkt, das gelöscht werden soll. Format: accounts/{account}/products/{product}/localInventories/{store_code}

DeleteRegionalInventoryRequest

Anfragenachricht für die Methode DeleteRegionalInventory.

Felder
name

string

Erforderlich. Der Name der zu löschenden RegionalInventory-Ressource. Format: accounts/{account}/products/{product}/regionalInventories/{region}

InsertLocalInventoryRequest

Anfragenachricht für die Methode InsertLocalInventory.

Felder
parent

string

Erforderlich. Das Konto und das Produkt, in das dieses Inventar eingefügt werden soll. Format: accounts/{account}/products/{product}

local_inventory

LocalInventory

Erforderlich. Informationen zum lokalen Inventar des Produkts. Wenn für das Produkt bereits eine LocalInventory-Ressource für dieselbe storeCode vorhanden ist, wird die LocalInventory-Ressource vollständig ersetzt.

InsertRegionalInventoryRequest

Anfragenachricht für die Methode InsertRegionalInventory.

Felder
parent

string

Erforderlich. Das Konto und das Produkt, in das dieses Inventar eingefügt werden soll. Format: accounts/{account}/products/{product}

regional_inventory

RegionalInventory

Erforderlich. Regionale Inventarinformationen, die dem Produkt hinzugefügt werden sollen. Wenn für das Produkt bereits eine RegionalInventory-Ressource für dieselbe region vorhanden ist, wird die RegionalInventory-Ressource vollständig ersetzt.

ListLocalInventoriesRequest

Anfragenachricht für die Methode ListLocalInventories.

Felder
parent

string

Erforderlich. Die name des übergeordneten Produkts, für das lokales Inventar aufgeführt werden soll. Format: accounts/{account}/products/{product}

page_size

int32

Die maximale Anzahl von LocalInventory-Ressourcen, die für das betreffende Produkt zurückgegeben werden sollen. Der Dienst gibt weniger als diesen Wert zurück, wenn die Anzahl der Inventare für das betreffende Produkt unter pageSize liegt. Der Standardwert ist 25.000. Der Höchstwert ist 25.000. Wenn ein Wert angegeben wird, der über dem Höchstwert liegt, wird pageSize standardmäßig auf den Höchstwert gesetzt.

page_token

string

Ein Seitentoken, das von einem vorherigen ListLocalInventories-Aufruf empfangen wurde. Geben Sie das Seitentoken an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListLocalInventories bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat. Das Token, das in der Antwort auf die vorherige Anfrage als nextPageToken zurückgegeben wurde.

ListLocalInventoriesResponse

Antwortnachricht für die Methode ListLocalInventories.

Felder
local_inventories[]

LocalInventory

Die LocalInventory Ressourcen für das angegebene Produkt aus dem angegebenen Konto.

next_page_token

string

Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

ListRegionalInventoriesRequest

Anfragenachricht für die Methode ListRegionalInventories.

Felder
parent

string

Erforderlich. Die name des übergeordneten Produkts, für das RegionalInventory-Ressourcen aufgeführt werden sollen. Format: accounts/{account}/products/{product}

page_size

int32

Die maximale Anzahl von RegionalInventory-Ressourcen, die für das betreffende Produkt zurückgegeben werden sollen. Der Dienst gibt weniger als diesen Wert zurück, wenn die Anzahl der Inventare für das betreffende Produkt unter pageSize liegt. Der Standardwert ist 25.000. Der Höchstwert ist 100.000. Wenn ein Wert angegeben wird, der über dem Höchstwert liegt, wird pageSize standardmäßig auf den Höchstwert gesetzt.

page_token

string

Ein Seitentoken, das von einem vorherigen ListRegionalInventories-Aufruf empfangen wurde. Geben Sie das Seitentoken an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListRegionalInventories bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat. Das Token, das in der Antwort auf die vorherige Anfrage als nextPageToken zurückgegeben wurde.

ListRegionalInventoriesResponse

Antwortnachricht für die Methode ListRegionalInventories.

Felder
regional_inventories[]

RegionalInventory

Die RegionalInventory Ressourcen für das angegebene Produkt aus dem angegebenen Konto.

next_page_token

string

Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

LocalInventory

Informationen zum lokalen Inventar des Produkts. Stellt Informationen zu einem bestimmten Produkt im Geschäft dar, das mit storeCode angegeben ist. Eine Liste aller zulässigen Attributwerte finden Sie in der Spezifikation für Daten zu lokalem Inventar.

Felder
name

string

Nur Ausgabe. Der Name der LocalInventory-Ressource. Format: accounts/{account}/products/{product}/localInventories/{store_code}

account

int64

Nur Ausgabe. Das Konto, zu dem das Produkt gehört. Dieses Feld wird ignoriert, wenn es vom Kunden festgelegt wird.

store_code

string

Erforderlich. Nicht veränderbar. Geschäftscode (Geschäfts-ID aus Ihrem Unternehmensprofil) des Ladengeschäfts, in dem das Produkt verkauft wird. Weitere Informationen finden Sie in der Datenspezifikation für lokales Inventar.

price

Price

Der Preis des Produkts in diesem Geschäft.

sale_price

Price

Der Sonderangebotspreis des Produkts in diesem Geschäft. Erforderlich, wenn salePriceEffectiveDate definiert ist.

sale_price_effective_date

Interval

Der TimePeriod des Angebots in diesem Geschäft.

custom_attributes[]

CustomAttribute

Eine Liste von benutzerdefinierten (vom Händler bereitgestellten) Attributen. Sie können CustomAttribute auch verwenden, um jedes Attribut der Datenspezifikation in seiner generischen Form einzureichen.

availability

string

Verfügbarkeit des Produkts in diesem Geschäft. Zulässige Attributwerte finden Sie in der Datenspezifikation für lokales Inventar von Produkten.

quantity

int64

Die im Geschäft verfügbare Menge des Produkts. Muss größer oder gleich null sein.

pickup_method

string

Unterstützte Abholmethode für dieses Produkt. Sofern der Wert nicht "not supported" ist, muss dieses Feld zusammen mit pickupSla eingereicht werden. Zulässige Attributwerte finden Sie in der Datenspezifikation für lokales Inventar von Produkten.

pickup_sla

string

Relativer Zeitraum ab dem Bestelldatum, bis eine Bestellung für dieses Produkt in diesem Geschäft zur Abholung bereitsteht. Muss mit pickupMethod eingereicht werden. Zulässige Attributwerte finden Sie in der Datenspezifikation für lokales Inventar von Produkten.

instore_product_location

string

Standort des Produkts im Geschäft. Die maximale Länge beträgt 20 Byte.

RegionalInventory

Regionale Inventarinformationen für das Produkt. Stellt spezifische Informationen wie Preis und Verfügbarkeit für ein bestimmtes Produkt in einer bestimmten region dar. Eine Liste aller zulässigen Attributwerte finden Sie in der Datenspezifikation für regionales Inventar.

Felder
name

string

Nur Ausgabe. Der Name der RegionalInventory-Ressource. Format: {regional_inventory.name=accounts/{account}/products/{product}/regionalInventories/{region}

account

int64

Nur Ausgabe. Das Konto, zu dem das Produkt gehört. Dieses Feld wird ignoriert, wenn es vom Kunden festgelegt wird.

region

string

Erforderlich. Nicht veränderbar. ID der Region für diese RegionalInventory-Ressource. Weitere Informationen finden Sie unter Angabe regionaler Preise und Verfügbarkeit.

price

Price

Preis des Produkts in dieser Region.

sale_price

Price

Der Sonderangebotspreis des Produkts in dieser Region. Erforderlich, wenn salePriceEffectiveDate definiert ist.

sale_price_effective_date

Interval

Der TimePeriod des Sonderangebotspreises in dieser Region.

custom_attributes[]

CustomAttribute

Eine Liste von benutzerdefinierten (vom Händler bereitgestellten) Attributen. Sie können CustomAttribute auch verwenden, um jedes Attribut der Datenspezifikation in seiner generischen Form einzureichen.

availability

string

Verfügbarkeit des Produkts in dieser Region. Zulässige Attributwerte finden Sie in der Spezifikation für regionale Produktinventardaten.