Package google.shopping.merchant.lfp.v1beta

Index

LfpInventoryService

Ein Dienst für einen LFP-Partner, über den lokale Inventare für einen Händler eingereicht werden können.

InsertLfpInventory

rpc InsertLfpInventory(InsertLfpInventoryRequest) returns (LfpInventory)

Fügt eine LfpInventory-Ressource für das angegebene Zielhändlerkonto ein. Wenn die Ressource bereits vorhanden ist, wird sie ersetzt. Das Inventar läuft nach 30 Tagen automatisch ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

LfpSaleService

Dienst für einen LFP-Partner zum Einreichen von Verkaufsdaten für einen Händler

InsertLfpSale

rpc InsertLfpSale(InsertLfpSaleRequest) returns (LfpSale)

Fügt ein LfpSale für den angegebenen Händler ein.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

LfpStoreService

Dienst für einen LFP-Partner zum Einreichen lokaler Geschäfte eines Händlers.

DeleteLfpStore

rpc DeleteLfpStore(DeleteLfpStoreRequest) returns (Empty)

Löscht ein Geschäft für einen Zielhändler.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
GetLfpStore

rpc GetLfpStore(GetLfpStoreRequest) returns (LfpStore)

Ruft Informationen zu einem Geschäft ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
InsertLfpStore

rpc InsertLfpStore(InsertLfpStoreRequest) returns (LfpStore)

Fügt ein Geschäft für den Zielhändler ein. Wenn ein Geschäft mit diesem Geschäftscode bereits vorhanden ist, wird er ersetzt.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
ListLfpStores

rpc ListLfpStores(ListLfpStoresRequest) returns (ListLfpStoresResponse)

Listet die Geschäfte des Zielhändlers auf, wie durch den Filter in ListLfpStoresRequest angegeben.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

DeleteLfpStoreRequest

Anfragenachricht für die DeleteLfpStore-Methode.

Felder
name

string

Erforderlich. Der Name des Geschäfts, das für das Ziel-Händlerkonto gelöscht werden soll. Format: accounts/{account}/lfpStores/{target_merchant}~{store_code}

GetLfpStoreRequest

Anfragenachricht für die Methode GetLfpStore.

Felder
name

string

Erforderlich. Der Name des abzurufenden Speichers. Format: accounts/{account}/lfpStores/{target_merchant}~{store_code}

InsertLfpInventoryRequest

Anfragenachricht für die Methode InsertLfpInventory.

Felder
parent

string

Erforderlich. Das LFP-Anbieterkonto. Format: accounts/{account}
lfp_inventory

LfpInventory

Erforderlich. Das einzufügende Inventar.

InsertLfpSaleRequest

Anfragenachricht für die Methode „InsertLfpSale“

Felder
parent

string

Erforderlich. Das LFP-Anbieterkonto. Format: accounts/{lfp_partner}
lfp_sale

LfpSale

Erforderlich. Das einzufügende Angebot.

InsertLfpStoreRequest

Anfragenachricht für die Methode „InsertLfpStore“.

Felder
parent

string

Erforderlich. Format des LFP-Anbieterkontos: accounts/{account}
lfp_store

LfpStore

Erforderlich. Der einzufügende Shop.

LfpInventory

Lokales Inventar für den Händler

Felder
name

string

Nur Ausgabe. Kennung. Der Name für die Ressource LfpInventory. Format: accounts/{account}/lfpInventories/{target_merchant}~{store_code}~{offer}
target_account

int64

Erforderlich. Die Merchant Center-ID des Händlers, für den das Inventar eingereicht werden soll.
store_code

string

Erforderlich. Die Kennung des Geschäfts des Händlers. Entweder der über InsertLfpStore eingefügte Geschäftscode oder der Geschäftscode im Unternehmensprofil.
offer_id

string

Erforderlich. Nicht veränderbar. Eine eindeutige Kennzeichnung für das Produkt. Wenn sowohl Inventare als auch Verkäufe für einen Händler eingereicht werden, muss diese ID für dasselbe Produkt übereinstimmen.

Hinweis: Wenn der Händler das gleiche Produkt neu und gebraucht verkauft, sollten die Produkte mit unterschiedlichen IDs gekennzeichnet sein.
region_code

string

Erforderlich. Der CLDR-Gebietscode für das Land, in dem das Produkt verkauft wird.
content_language

string

Erforderlich. Der aus zwei Buchstaben bestehende ISO 639-1-Sprachcode für den Artikel.
price

Price

Optional. Der aktuelle Preis des Produkts.
availability

string

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

Timestamp

Optional. Der Zeitpunkt, zu dem das Inventar erfasst wird. Wenn nichts festgelegt ist, wird der Zeitpunkt angegeben, zu dem das Inventar eingereicht wird.
gtin

string

Optional. Die Global Trade Item Number des Produkts.
quantity

int64

Optional. Menge des in diesem Geschäft verfügbaren Produkts Muss größer oder gleich null sein.
pickup_method

string

Optional. Unterstützte Abholoption für dieses Angebot. Sofern der Wert nicht „nicht unterstützt“ lautet, muss dieses Feld zusammen mit pickupSla eingereicht werden. Zulässige Attributwerte finden Sie in der Datenspezifikation für lokales Inventar.
pickup_sla

string

Optional. Voraussichtliches Datum, an dem eine Bestellung relativ zum Bestelldatum zur Abholung bereit ist. Muss zusammen mit pickupMethod eingereicht werden. Zulässige Attributwerte finden Sie in der Datenspezifikation für lokales Inventar.
feed_label

string

Optional. Das Feedlabel des Produkts. Wenn sie nicht festgelegt ist, wird standardmäßig regionCode verwendet.

LfpSale

Ein Angebot für den Händler.

Felder
name

string

Nur Ausgabe. Kennung. Der Name der LfpSale-Ressource. Format: accounts/{account}/lfpSales/{sale}
target_account

int64

Erforderlich. Die Merchant Center-ID des Händlers, für den das Angebot eingereicht werden soll.
store_code

string

Erforderlich. Die Kennung des Geschäfts des Händlers. Entweder eine storeCode, die über die API eingefügt wurde, oder den Code des Geschäfts im Unternehmensprofil.
offer_id

string

Erforderlich. Eine eindeutige Kennzeichnung für das Produkt. Wenn sowohl Inventare als auch Verkäufe für einen Händler eingereicht werden, muss diese ID für dasselbe Produkt übereinstimmen.

Hinweis: Wenn der Händler das gleiche Produkt neu und gebraucht verkauft, sollten die Produkte mit unterschiedlichen IDs gekennzeichnet sein.
region_code

string

Erforderlich. Der CLDR-Gebietscode für das Land, in dem das Produkt verkauft wird.
content_language

string

Erforderlich. Der aus zwei Buchstaben bestehende ISO 639-1-Sprachcode für den Artikel.
gtin

string

Erforderlich. Die Global Trade Item Number des verkauften Produkts.
price

Price

Erforderlich. Der Preis pro Einheit des Produkts.
quantity

int64

Erforderlich. Die relative Änderung der verfügbaren Menge. Negativ für zurückgegebene Artikel.
sale_time

Timestamp

Erforderlich. Der Zeitstempel des Verkaufs.
uid

string

Nur Ausgabe. Vom System generierte global eindeutige ID für LfpSale.
feed_label

string

Optional. Das Feedlabel des Produkts. Wenn sie nicht festgelegt ist, wird standardmäßig regionCode verwendet.

LfpStore

Ein Geschäft für den Händler. Diese Angaben werden für den Abgleich mit einem Geschäft im Google Unternehmensprofil des Zielhändlers verwendet. Wenn kein entsprechendes Geschäft gefunden wird, werden die mit dem Geschäftscode eingereichten Inventare und Verkäufe nicht verwendet.

Felder
name

string

Nur Ausgabe. Kennung. Der Name der LfpStore-Ressource. Format: accounts/{account}/lfpStores/{target_merchant}~{store_code}
target_account

int64

Erforderlich. Die Merchant Center-ID des Händlers, für den der Shop eingereicht werden soll.
store_code

string

Erforderlich. Nicht veränderbar. Eine Geschäfts-ID, die für den Zielhändler eindeutig ist.
store_address

string

Erforderlich. Die Adresse des Geschäfts. Beispiel: 1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA.
gcid_category[]

string

Optional. Google My Business-Kategorie-ID
matching_state

StoreMatchingState

Optional. Nur Ausgabe. Der Status der Zuordnung zu einem Unternehmensprofil. Wenn keine Übereinstimmung gefunden wird, findest du weitere Informationen unter matchingStateHint.
store_name

string

Optional. Händler- oder Shopname
phone_number

string

Optional. Die Telefonnummer des Geschäfts im Format E.164. Beispiel: +15556767888
website_uri

string

Optional. Die Website-URL des Geschäfts oder Händlers.
place_id

string

Optional. Die Google Place ID des Geschäftsstandorts.
matching_state_hint

string

Optional. Nur Ausgabe. Der Hinweis, warum der Abgleich fehlgeschlagen ist. Wird nur festgelegt, wenn matchingState=STORE_MATCHING_STATE_FAILED.

Folgende Werte sind möglich:

  • „linked-store-not-found“: Es sind keine Google Unternehmensprofil-Geschäfte für den Abgleich verfügbar.
  • „store-match-not-found“: Die angegebene(n) LfpStore konnte keinem der verknüpften Google Unternehmensprofil-Geschäfte zugeordnet werden. Das Merchant Center-Konto ist korrekt verknüpft und die Geschäfte sind im Google Unternehmensprofil verfügbar. Die Adresse des Standorts „LfpStore“ stimmt jedoch nicht mit der Adresse der Geschäfte in Google Unternehmensprofil überein. Aktualisieren Sie die Adresse „LfpStore“ oder die Adresse Ihres Google Unternehmensprofil-Geschäfts, damit sie übereinstimmen.
  • „store-match-unverified“: Die angegebene(n) LfpStore konnte keinem der verknüpften Google Unternehmensprofil-Geschäfte zugeordnet werden, da das zugeordnete Google Unternehmensprofil-Geschäft nicht bestätigt ist. Führen Sie den Bestätigungsprozess für das Google Unternehmensprofil durch, damit das Unternehmen korrekt zugeordnet werden kann.

StoreMatchingState

Der Status der Zuordnung von LfpStore mit einem Google Unternehmensprofil.

Enums
STORE_MATCHING_STATE_UNSPECIFIED Übereinstimmungsstatus des Geschäfts nicht angegeben.
STORE_MATCHING_STATE_MATCHED Die LfpStore wurde einem Google Unternehmensprofil-Geschäft zugeordnet.
STORE_MATCHING_STATE_FAILED Die LfpStore ist keinem Google Unternehmensprofil-Geschäft zugeordnet.

ListLfpStoresRequest

Anfragenachricht für die ListLfpStores-Methode.

Felder
parent

string

Erforderlich. Der LFP-Partner. Format: accounts/{account}
target_account

int64

Erforderlich. Die Merchant Center-ID des Händlers, für den Geschäfte aufgelistet werden sollen.
page_size

int32

Optional. Die maximale Anzahl von LfpStore-Ressourcen, die für das angegebene Konto zurückgegeben werden sollen. Der Dienst gibt weniger als diesen Wert zurück, wenn die Anzahl der Geschäfte für das angegebene Konto kleiner als pageSize ist. Der Standardwert ist 250. Der Maximalwert beträgt 1.000. Wenn ein größerer Wert als der Höchstwert angegeben wird, wird pageSize standardmäßig auf den Maximalwert verwendet.
page_token

string

Optional. Ein Seitentoken, das von einem vorherigen ListLfpStoresRequest-Aufruf empfangen wurde. Geben Sie das Seitentoken an, um die nachfolgende Seite abzurufen. Beim Paginieren müssen alle anderen für ListLfpStoresRequest bereitgestellten Parameter mit dem Aufruf übereinstimmen, über den das Seitentoken bereitgestellt wurde. Das Token, das in der Antwort auf die vorherige Anfrage als nextPageToken zurückgegeben wurde.

ListLfpStoresResponse

Antwortnachricht für die Methode ListLfpStores.

Felder
lfp_stores[]

LfpStore

Die Geschäfte des angegebenen Händlers.
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.