Package google.shopping.merchant.lfp.v1beta

Index

LfpInventoryService

Dienst für LFP-Partner zum Einreichen lokalen Inventars für einen Händler.

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 unter OAuth 2.0 Overview.

LfpSaleService

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

InsertLfpSale

rpc InsertLfpSale(InsertLfpSaleRequest) returns (LfpSale)

Ein LfpSale für den angegebenen Händler wird eingefügt.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

LfpStoreService

Dienst für einen LFP-Partner, mit dem er lokale Geschäfte für einen Händler einreichen kann.

DeleteLfpStore

rpc DeleteLfpStore(DeleteLfpStoreRequest) returns (Empty)

Löscht einen Store für einen Zielhändler.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.
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 unter OAuth 2.0 Overview.
InsertLfpStore

rpc InsertLfpStore(InsertLfpStoreRequest) returns (LfpStore)

Fügen Sie einen Store für den Zielhändler ein. Wenn der Shop mit demselben Geschäftscode bereits vorhanden ist, wird er ersetzt.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.
ListLfpStores

rpc ListLfpStores(ListLfpStoresRequest) returns (ListLfpStoresResponse)

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

DeleteLfpStoreRequest

Anfragenachricht für die Methode „DeleteLfpStore“.

Felder
name

string

Erforderlich. Der Name des Geschäfts, das für das Zielhä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 Geschäfts. Format: accounts/{account}/lfpStores/{target_merchant}~{store_code}

InsertLfpInventoryRequest

Anfragenachricht für die Methode InsertLfpInventory.

Felder
parent

string

Erforderlich. Das Konto des LFP-Anbieters. Format: accounts/{account}
lfp_inventory

LfpInventory

Erforderlich. Das einzufügende Inventar.

InsertLfpSaleRequest

Anfragenachricht für die Methode „InsertLfpSale“.

Felder
parent

string

Erforderlich. Das Konto des LFP-Anbieters. Format: accounts/{lfp_partner}
lfp_sale

LfpSale

Erforderlich. Der einzufügende Angebotspreis.

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 der LfpInventory-Ressource. 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 Kennung für das Produkt. Wenn für einen Händler sowohl Inventar als auch Verkäufe eingereicht werden, muss diese ID für dasselbe Produkt übereinstimmen.

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

string

Erforderlich. Der CLDR-Regionalcode 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 von Produkten.
collection_time

Timestamp

Optional. Der Zeitpunkt, zu dem das Inventar erfasst wird. Wenn dieser Wert nicht festgelegt ist, wird er auf die Uhrzeit festgelegt, zu der das Inventar eingereicht wurde.
gtin

string

Optional. Die Global Trade Item Number (GTIN) des Produkts.
quantity

int64

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

string

Optional. Unterstützte Abholmethode 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. Das Datum, an dem eine Bestellung relativ zum Bestelldatum zur Abholung bereitsteht. Muss zusammen mit pickupMethod eingereicht werden. Zulässige Attributwerte finden Sie in der Datenspezifikation für lokales Inventar.
feed_label

string

Optional. Das Feedlabel für das Produkt. Ist dieser Wert nicht festgelegt, wird standardmäßig regionCode verwendet.

LfpSale

Ein Verkauf 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 der Verkauf eingereicht werden soll.
store_code

string

Erforderlich. Die Kennung des Geschäfts des Händlers. Entweder ein über die API eingefügtes storeCode oder der Code des Geschäfts im Unternehmensprofil.
offer_id

string

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

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

string

Erforderlich. Der CLDR-Regionalcode 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 (GTIN) des verkauften Produkts.
price

Price

Erforderlich. Der Stückpreis des Produkts.
quantity

int64

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

Timestamp

Erforderlich. Der Zeitstempel für den Verkauf.
uid

string

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

string

Optional. Das Feedlabel für das Produkt. Ist dieser Wert nicht festgelegt, wird standardmäßig regionCode verwendet.

LfpStore

Ein Geschäft für den Händler. Anhand dieser Informationen wird eine Übereinstimmung mit einem Geschäft im Google Unternehmensprofil des Zielhändlers ermittelt. Wenn kein passender Shop gefunden werden kann, werden die mit dem Shopcode eingereichten Inventare oder 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 Unternehmensprofil-Kategorie-ID
matching_state

StoreMatchingState

Optional. Nur Ausgabe. Der Abgleichsstatus mit einem Google Unternehmensprofil. Weitere Informationen finden Sie unter matchingStateHint, wenn keine Übereinstimmung gefunden wird.
store_name

string

Optional. Händler- oder Shopname
phone_number

string

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

string

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

string

Optional. Die Google Orts-ID der Filiale.
matching_state_hint

string

Optional. Nur Ausgabe. Ein Hinweis darauf, warum die Zuordnung fehlgeschlagen ist. Dieser Wert wird nur festgelegt, wenn matchingState=STORE_MATCHING_STATE_FAILED ist.

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 LfpStore konnte keinem der verknüpften Google Unternehmensprofil-Geschäfte zugeordnet werden. Das Merchant Center-Konto ist richtig verknüpft und die Geschäfte sind im Google Unternehmensprofil verfügbar. Die Adresse des LfpStore-Geschäfts stimmt jedoch nicht mit der Adresse des Google Unternehmensprofil-Geschäfts überein. Aktualisieren Sie die Adresse des LfpStore-Geschäfts oder des Google Unternehmensprofil-Geschäfts, damit diese übereinstimmen.
  • „store-match-unverified“: Die angegebene LfpStore konnte keinem der verknüpften Google Unternehmensprofil-Geschäfte zugeordnet werden, da das übereinstimmende Google Unternehmensprofil-Geschäft nicht bestätigt ist. Führen Sie den Bestätigungsprozess für Google Unternehmensprofile durch, um eine korrekte Zuordnung vorzunehmen.

StoreMatchingState

Der Abgleichsstatus von LfpStore mit einem Google Unternehmensprofil.

Enums
STORE_MATCHING_STATE_UNSPECIFIED Der Zuordnungsstatus des Geschäfts ist nicht angegeben.
STORE_MATCHING_STATE_MATCHED Die LfpStore wurde erfolgreich einem Google Unternehmensprofil-Geschäft zugeordnet.
STORE_MATCHING_STATE_FAILED Die LfpStore stimmt nicht mit einem Google Unternehmensprofil-Geschäft überein.

ListLfpStoresRequest

Anfragenachricht für die Methode „ListLfpStores“.

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 aufgeführt werden sollen.
page_size

int32

Optional. Die maximale Anzahl von LfpStore-Ressourcen, die für das betreffende Konto zurückgegeben werden sollen. Der Dienst gibt weniger als diesen Wert zurück, wenn die Anzahl der Geschäfte für das betreffende Konto unter pageSize liegt. Der Standardwert ist 250. Der Höchstwert ist 1.000. Wenn ein Wert angegeben wird, der über dem Höchstwert liegt, wird pageSize standardmäßig auf den Höchstwert gesetzt.
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, der das Seitentoken bereitgestellt hat. 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.