Package google.shopping.merchant.lfp.v1beta

Indice

LfpInventoryService

Servizio per un partner LFP per inviare inventari locali per un commerciante.

InsertLfpInventory

rpc InsertLfpInventory(InsertLfpInventoryRequest) returns (LfpInventory)

Inserisce una risorsa LfpInventory per l'account commerciante di destinazione specificato. Se la risorsa esiste già, verrà sostituita. L'inventario scade automaticamente dopo 30 giorni.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

LfpSaleService

Servizio per un partner LFP per inviare i dati di vendita di un commerciante.

InsertLfpSale

rpc InsertLfpSale(InsertLfpSaleRequest) returns (LfpSale)

Inserisce un LfpSale per il commerciante specificato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

LfpStoreService

Servizio per un partner LFP per inviare i negozi locali di un commerciante.

DeleteLfpStore

rpc DeleteLfpStore(DeleteLfpStoreRequest) returns (Empty)

Consente di eliminare un negozio per un commerciante di destinazione.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
GetLfpStore

rpc GetLfpStore(GetLfpStoreRequest) returns (LfpStore)

Recupera le informazioni su un negozio.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
InsertLfpStore

rpc InsertLfpStore(InsertLfpStoreRequest) returns (LfpStore)

Inserisce un negozio per il commerciante target. Se il negozio con lo stesso codice negozio esiste già, verrà sostituito.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
ListLfpStores

rpc ListLfpStores(ListLfpStoresRequest) returns (ListLfpStoresResponse)

Elenca i negozi del commerciante di destinazione, specificati dal filtro in ListLfpStoresRequest.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

DeleteLfpStoreRequest

Messaggio di richiesta per il metodo DeleteLfpStore.

Campi
name

string

Obbligatorio. Il nome del negozio da eliminare per l'account commerciante di destinazione. Formato: accounts/{account}/lfpStores/{target_merchant}~{store_code}

GetLfpStoreRequest

Messaggio di richiesta per il metodo GetLfpStore.

Campi
name

string

Obbligatorio. Il nome del negozio da recuperare. Formato: accounts/{account}/lfpStores/{target_merchant}~{store_code}

InsertLfpInventoryRequest

Messaggio di richiesta per il metodo InsertLfpInventory.

Campi
parent

string

Obbligatorio. L'account del fornitore LFP. Formato: accounts/{account}
lfp_inventory

LfpInventory

Obbligatorio. L'inventario da inserire.

InsertLfpSaleRequest

Messaggio di richiesta per il metodo InsertLfpSale.

Campi
parent

string

Obbligatorio. L'account del fornitore LFP. Formato: accounts/{lfp_partner}
lfp_sale

LfpSale

Obbligatorio. La vendita da inserire.

InsertLfpStoreRequest

Messaggio di richiesta per il metodo InsertLfpStore.

Campi
parent

string

Obbligatorio. Formato dell'account del fornitore LFP: accounts/{account}
lfp_store

LfpStore

Obbligatorio. Il negozio da inserire.

LfpInventory

Inventario locale per il commerciante.

Campi
name

string

Solo output. Identificatore. Il nome della risorsa LfpInventory. Formato: accounts/{account}/lfpInventories/{target_merchant}~{store_code}~{offer}
target_account

int64

Obbligatorio. L'ID Merchant Center del commerciante per cui inviare l'inventario.
store_code

string

Obbligatorio. L'identificatore del negozio del commerciante. Il codice negozio inserito tramite InsertLfpStore o il codice negozio nel Profilo dell'attività.
offer_id

string

Obbligatorio. Immutabile. Un identificatore univoco del prodotto. Se per un commerciante vengono inviati sia gli inventari che le vendite, questo ID deve corrispondere allo stesso prodotto.

Nota: se il commerciante vende lo stesso prodotto sia nuovo che usato, gli ID devono essere diversi.
region_code

string

Obbligatorio. Il codice di territorio CLDR per il paese in cui viene venduto il prodotto.
content_language

string

Obbligatorio. Il codice lingua ISO 639-1 di due lettere dell'elemento.
price

Price

(Facoltativo) Il prezzo corrente del prodotto.
availability

string

Obbligatorio. Disponibilità del prodotto in questo negozio. Per i valori degli attributi accettati, consulta la specifica dei dati di inventario locale dei prodotti.
collection_time

Timestamp

(Facoltativo) L'ora in cui viene raccolto l'inventario. Se non viene impostato, verrà impostato sull'ora in cui viene inviato l'inventario.
gtin

string

(Facoltativo) Il codice Global Trade Item Number (GTIN) del prodotto.
quantity

int64

(Facoltativo) Quantità del prodotto disponibile in questo negozio. Deve essere maggiore o uguale a zero.
pickup_method

string

(Facoltativo) Metodo di ritiro supportato per questa offerta. A meno che il valore non sia "not supported", questo campo deve essere inviato insieme a pickupSla. Per i valori degli attributi accettati, consulta la specifica dei dati di inventario locale dei prodotti.
pickup_sla

string

(Facoltativo) Data prevista in cui un ordine sarà pronto per il ritiro rispetto alla data dell'ordine. Deve essere inviata insieme a pickupMethod. Per i valori degli attributi accettati, consulta la specifica dei dati di inventario locale dei prodotti.
feed_label

string

(Facoltativo) L'etichetta del feed per il prodotto. Se non è impostato, il valore predefinito è regionCode.

LfpSale

Una vendita per il commerciante.

Campi
name

string

Solo output. Identificatore. Il nome della risorsa LfpSale. Formato: accounts/{account}/lfpSales/{sale}
target_account

int64

Obbligatorio. L'ID Merchant Center del commerciante per cui inviare la vendita.
store_code

string

Obbligatorio. L'identificatore del negozio del commerciante. Un storeCode inserito tramite l'API o il codice del negozio nel profilo dell'attività.
offer_id

string

Obbligatorio. Un identificatore univoco del prodotto. Se per un commerciante vengono inviati sia gli inventari che le vendite, questo ID deve corrispondere allo stesso prodotto.

Nota: se il commerciante vende lo stesso prodotto sia nuovo che usato, gli ID devono essere diversi.
region_code

string

Obbligatorio. Il codice di territorio CLDR per il paese in cui viene venduto il prodotto.
content_language

string

Obbligatorio. Il codice lingua ISO 639-1 di due lettere dell'elemento.
gtin

string

Obbligatorio. Il codice Global Trade Item Number (GTIN) del prodotto venduto.
price

Price

Obbligatorio. Il prezzo unitario del prodotto.
quantity

int64

Obbligatorio. La variazione relativa della quantità disponibile. Valore negativo per gli articoli restituiti.
sale_time

Timestamp

Obbligatorio. Il timestamp della vendita.
uid

string

Solo output. ID univoco globale generato dal sistema per il LfpSale.
feed_label

string

(Facoltativo) L'etichetta del feed per il prodotto. Se non è impostato, il valore predefinito è regionCode.

LfpStore

Un negozio per il commerciante. Verrà utilizzato per trovare una corrispondenza con un negozio nel Profilo dell'attività su Google del commerciante di destinazione. Se non è possibile trovare un negozio corrispondente, gli inventari o le vendite inviati con il codice negozio non verranno utilizzati.

Campi
name

string

Solo output. Identificatore. Il nome della risorsa LfpStore. Formato: accounts/{account}/lfpStores/{target_merchant}~{store_code}
target_account

int64

Obbligatorio. L'ID Merchant Center del commerciante per cui inviare il negozio.
store_code

string

Obbligatorio. Immutabile. Un identificatore negozio univoco per il commerciante di destinazione.
store_address

string

Obbligatorio. L'indirizzo del negozio. Esempio: 1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA.
gcid_category[]

string

(Facoltativo) ID categoria di Google My Business.
matching_state

StoreMatchingState

(Facoltativo) Solo output. Lo stato della corrispondenza a un Profilo dell'attività su Google. Per ulteriori dettagli, consulta matchingStateHint se non viene trovata alcuna corrispondenza.
store_name

string

(Facoltativo) Il nome del commerciante o del negozio.
phone_number

string

(Facoltativo) Il numero di telefono del negozio in formato E.164. Esempio: +15556767888
website_uri

string

(Facoltativo) L'URL del sito web del negozio o del commerciante.
place_id

string

(Facoltativo) L'ID posizione di Google della sede del negozio.
matching_state_hint

string

(Facoltativo) Solo output. Suggerimento del motivo per cui la corrispondenza non è riuscita. Viene impostato solo quando matchingState=STORE_MATCHING_STATE_FAILED.

I valori possibili sono:

  • "linked-store-not-found": non ci sono negozi del Profilo dell'attività su Google disponibili per la corrispondenza.
  • "store-match-not-found": non è stato possibile associare LfpStore fornito a nessun negozio del Profilo dell'attività su Google collegato. L'account Merchant Center è collegato correttamente e i negozi sono disponibili su Profilo dell'attività su Google, ma l'indirizzo della sede LfpStore non corrisponde a quelli dei negozi del Profilo dell'attività su Google. Aggiorna l'indirizzo LfpStore o l'indirizzo del negozio del Profilo dell'attività su Google in modo che corrispondano.
  • "store-match-unverified": non è stato possibile associare il valore LfpStore fornito a nessun negozio del Profilo dell'attività su Google collegato, in quanto il negozio del Profilo dell'attività su Google associato non è verificato. Per una corrispondenza corretta, segui la procedura di verifica di Profilo dell'attività su Google.

StoreMatchingState

Lo stato della corrispondenza di LfpStore a un profilo dell'attività su Google.

Enum
STORE_MATCHING_STATE_UNSPECIFIED Stato della corrispondenza del negozio non specificato.
STORE_MATCHING_STATE_MATCHED LfpStore corrisponde a un negozio del Profilo dell'attività su Google.
STORE_MATCHING_STATE_FAILED LfpStore non corrisponde a un negozio del Profilo dell'attività su Google.

ListLfpStoresRequest

Messaggio di richiesta per il metodo ListLfpStores.

Campi
parent

string

Obbligatorio. Il partner LFP. Formato: accounts/{account}
target_account

int64

Obbligatorio. L'ID Merchant Center del commerciante per cui elencare i negozi.
page_size

int32

(Facoltativo) Il numero massimo di risorse LfpStore da restituire per l'account specificato. Il servizio restituisce un numero inferiore a questo valore se il numero di negozi per l'account specificato è inferiore a pageSize. Il valore predefinito è 250. Il valore massimo è 1000. Se viene specificato un valore superiore al massimo, il valore predefinito di pageSize sarà il massimo.
page_token

string

(Facoltativo) Un token di pagina ricevuto da una chiamata ListLfpStoresRequest precedente. Fornisci il token di pagina per recuperare la pagina successiva. Quando viene applicata la paginazione, tutti gli altri parametri forniti a ListLfpStoresRequest devono corrispondere alla chiamata che ha fornito il token pagina. Il token restituito come nextPageToken nella risposta alla richiesta precedente.

ListLfpStoresResponse

Messaggio di risposta per il metodo ListLfpStores.

Campi
lfp_stores[]

LfpStore

I negozi del commerciante specificato.
next_page_token

string

Un token che può essere inviato come pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.