Package google.shopping.merchant.lfp.v1beta

Indice

LfpInventoryService

Servizio per un partner LFP per l'invio degli inventari locali di 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 pagina Panoramica di OAuth 2.0.

LfpSaleService

Servizio offerto a un partner LFP per l'invio dei dati di vendita per un commerciante.

InsertLfpSale

rpc InsertLfpSale(InsertLfpSaleRequest) returns (LfpSale)

Inserisce un valore LfpSale per il commerciante specificato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.

LfpStoreService

Servizio offerto a un partner LFP per specificare i negozi locali di un commerciante.

DeleteLfpStore

rpc DeleteLfpStore(DeleteLfpStoreRequest) returns (Empty)

Elimina 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 pagina Panoramica di OAuth 2.0.
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 pagina Panoramica di OAuth 2.0.
InsertLfpStore

rpc InsertLfpStore(InsertLfpStoreRequest) returns (LfpStore)

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.
ListLfpStores

rpc ListLfpStores(ListLfpStoresRequest) returns (ListLfpStoresResponse)

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.

DeleteLfpStoreRequest

Messaggio di richiesta per il metodo DeleteLfpStore.

Campi
name

string

Obbligatoria. 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

Obbligatoria. 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

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

LfpInventory

Obbligatoria. L'inventario da inserire.

InsertLfpSaleRequest

Messaggio di richiesta per il metodo InsertLfpSale.

Campi
parent

string

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

LfpSale

Obbligatoria. La vendita da inserire.

InsertLfpStoreRequest

Messaggio di richiesta per il metodo InsertLfpStore.

Campi
parent

string

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

LfpStore

Obbligatoria. Lo store 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

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

string

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

string

Obbligatoria. Immutabile. Un identificatore univoco del prodotto. Se per un commerciante vengono inviati sia inventari sia 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

Obbligatoria. Il codice di territorio CLDR del paese in cui viene venduto il prodotto.
content_language

string

Obbligatoria. Il codice lingua ISO 639-1 a due lettere dell'articolo.
price

Price

Campo facoltativo. Il prezzo corrente del prodotto.
availability

string

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

Timestamp

Campo facoltativo. L'ora in cui l'inventario viene raccolto. Se non viene configurato, verrà impostata l'ora in cui viene inviato l'inventario.
gtin

string

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

int64

Campo facoltativo. Quantità del prodotto disponibile in questo negozio. Deve essere maggiore o uguale a zero.
pickup_method

string

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

string

Campo facoltativo. Data prevista in cui un ordine sarà pronto per il ritiro in relazione alla data dell'ordine. Da inviare insieme a pickupMethod. Per i valori degli attributi accettati, consulta la specifica dei dati dell'inventario locale dei prodotti.
feed_label

string

Campo facoltativo. L'etichetta del feed per il prodotto. Se non viene configurato, il valore predefinito sarà 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

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

string

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

string

Obbligatoria. Un identificatore univoco del prodotto. Se per un commerciante vengono inviati sia inventari sia 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

Obbligatoria. Il codice di territorio CLDR del paese in cui viene venduto il prodotto.
content_language

string

Obbligatoria. Il codice lingua ISO 639-1 a due lettere dell'articolo.
gtin

string

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

Price

Obbligatoria. Il prezzo unitario del prodotto.
quantity

int64

Obbligatoria. La variazione relativa della quantità disponibile. Negativo per gli articoli restituiti.
sale_time

Timestamp

Obbligatoria. Il timestamp della vendita.
uid

string

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

string

Campo facoltativo. L'etichetta del feed per il prodotto. Se non viene configurato, il valore predefinito sarà regionCode.

LfpStore

Un negozio per il commerciante. Verrà utilizzato per l'associazione a un negozio nel Profilo dell'attività su Google del commerciante target. 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

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

string

Obbligatoria. Immutabile. Un identificatore del negozio univoco per il commerciante target.
store_address

string

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

string

Campo facoltativo. ID categoria di Google My Business.
matching_state

StoreMatchingState

Campo facoltativo. Solo output. Lo stato della corrispondenza a un profilo dell'attività su Google. Consulta matchingStateHint per ulteriori dettagli se non viene trovata alcuna corrispondenza.
store_name

string

Campo facoltativo. Il nome del commerciante o del negozio.
phone_number

string

Campo facoltativo. Il numero di telefono del negozio in formato E.164. Esempio: +15556767888
website_uri

string

Campo facoltativo. L'URL del sito web del negozio o del commerciante.
place_id

string

Campo facoltativo. L'ID Google Place della sede del negozio.
matching_state_hint

string

Campo facoltativo. Solo output. Suggerimento del motivo per cui la corrispondenza non è riuscita. È 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 abbinare il valore LfpStore specificato 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 di LfpStore non corrisponde a quelli dei negozi del Profilo dell'attività su Google. Aggiorna l'indirizzo di LfpStore o l'indirizzo del negozio del Profilo dell'attività su Google in modo che corrispondano.
  • "store-match-unverified": non è stato possibile abbinare il negozio LfpStore specificato a nessuno dei negozi del Profilo dell'attività su Google collegati, poiché il negozio del Profilo dell'attività su Google corrispondente non è verificato. Esegui la procedura di verifica di Profilo dell'attività su Google per stabilire la corrispondenza corretta.

StoreMatchingState

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

Enum
STORE_MATCHING_STATE_UNSPECIFIED Stato di corrispondenza negozio non specificato.
STORE_MATCHING_STATE_MATCHED Il LfpStore è stato abbinato correttamente 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

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

int64

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

int32

Campo 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, pageSize utilizzerà per impostazione predefinita il valore massimo.
page_token

string

Campo facoltativo. Un token di pagina, ricevuto da una chiamata ListLfpStoresRequest precedente. Fornisci il token di pagina per recuperare la pagina successiva. Durante l'impaginazione, tutti gli altri parametri forniti a ListLfpStoresRequest devono corrispondere alla chiamata che ha fornito il token della pagina. 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.