Package google.shopping.merchant.datasources.v1beta

Indice

DataSourcesService

Servizio per la gestione di principali, supplementari, inventari e altre origini dati. Scopri di più nell'articolo del Centro assistenza Merchant Center.

CreateDataSource

rpc CreateDataSource(CreateDataSourceRequest) returns (DataSource)

Crea la nuova configurazione dell'origine dati per l'account specificato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
DeleteDataSource

rpc DeleteDataSource(DeleteDataSourceRequest) returns (Empty)

Consente di eliminare un'origine dati dal tuo account Merchant Center.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
FetchDataSource

rpc FetchDataSource(FetchDataSourceRequest) returns (Empty)

Esegue immediatamente il recupero dei dati (anche al di fuori della pianificazione del recupero) su un'origine dati dal tuo account Merchant Center. Se hai bisogno di chiamare questo metodo più di una volta al giorno, devi utilizzare il servizio Products per aggiornare i dati di prodotto. Questo metodo funziona solo sulle origini dati con un set di input file.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
GetDataSource

rpc GetDataSource(GetDataSourceRequest) returns (DataSource)

Recupera la configurazione dell'origine dati per l'account specificato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
ListDataSources

rpc ListDataSources(ListDataSourcesRequest) returns (ListDataSourcesResponse)

Elenca le configurazioni delle origini dati per l'account specificato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
UpdateDataSource

rpc UpdateDataSource(UpdateDataSourceRequest) returns (DataSource)

Aggiorna la configurazione dell'origine dati esistente. I campi impostati nella maschera di aggiornamento ma non forniti nella risorsa verranno eliminati.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

CreateDataSourceRequest

Messaggio di richiesta per il metodo CreateDataSource.

Campi
parent

string

Obbligatoria. L'account in cui verrà creata l'origine dati. Formato: accounts/{account}
data_source

DataSource

Obbligatoria. L'origine dati da creare.

DataSource

L'origine dati dell'account Merchant Center.

Campi
name

string

Identificatore. Il nome dell'origine dati. Formato: {datasource.name=accounts/{account}/dataSources/{datasource}}
data_source_id

int64

Solo output. L'ID origine dati.
display_name

string

Obbligatoria. Il nome dell'origine dati visualizzato nell'interfaccia utente di Merchant Center.
input

Input

Solo output. Determina il tipo di input per l'origine dati. In base all'input, alcune impostazioni potrebbero non funzionare. Con l'API è possibile creare solo origini dati generiche.
file_input

FileInput

Campo facoltativo. Il campo viene utilizzato solo se i dati sono gestiti tramite un file.
Campo unione Type. Il tipo di origine dati. Type può essere solo uno dei seguenti:
primary_product_data_source

PrimaryProductDataSource

Obbligatoria. L'origine dati principale per i prodotti locali e online.
supplemental_product_data_source

SupplementalProductDataSource

Obbligatoria. L'origine dati supplementare per i prodotti locali e online.
local_inventory_data_source

LocalInventoryDataSource

Obbligatoria. L'origine dati inventario locale.
regional_inventory_data_source

RegionalInventoryDataSource

Obbligatoria. L'origine dati inventario regionale.
promotion_data_source

PromotionDataSource

Obbligatoria. L'origine dati della promozione.

Salvaguardie

Determina il tipo di input per l'origine dati. In base all'input, alcune impostazioni potrebbero non essere supportate.

Enum
INPUT_UNSPECIFIED Input non specificato.
API Rappresenta le origini dati per le quali i dati vengono forniti principalmente tramite l'API.
FILE Rappresenta le origini dati per le quali i dati vengono forniti principalmente tramite l'input di un file. I dati possono comunque essere forniti tramite l'API.
UI

L'origine dati per i prodotti aggiunti direttamente in Merchant Center.

Questo tipo di origine dati non può essere creata o aggiornata tramite questa API, ma solo dall'interfaccia utente di Merchant Center.

Questo tipo di origine dati è di sola lettura.
AUTOFEED Questo è anche noto come feed automatici, utilizzato per creare automaticamente i dati di prodotto. Questo tipo di origine dati può essere attivata o disattivata tramite il bundle Account.

DeleteDataSourceRequest

Messaggio di richiesta per il metodo DeleteDataSource.

Campi
name

string

Obbligatoria. Il nome dell'origine dati da eliminare. Formato: accounts/{account}/dataSources/{datasource}

FetchDataSourceRequest

Messaggio di richiesta per il metodo FetchDataSource.

Campi
name

string

Obbligatoria. Il nome della risorsa dell'origine dati da recuperare. Formato: accounts/{account}/dataSources/{datasource}

FileInput

I dati specifici per le origini dati dei file. Questo campo è vuoto per gli altri input dell'origine dati.

Campi
fetch_settings

FetchSettings

Campo facoltativo. Recupera i dettagli per pubblicare l'origine dati. Contiene le impostazioni per i tipi di input di file FETCH e GOOGLE_SHEETS. I campi obbligatori variano in base alla frequenza del recupero.
file_name

string

Campo facoltativo. Il nome file dell'origine dati. Obbligatorio per il tipo di input file UPLOAD.
file_input_type

FileInputType

Solo output. Il tipo di file di input.

FetchSettings

Recupera i dettagli per pubblicare l'origine dati.

Campi
enabled

bool

Campo facoltativo. Attiva o mette in pausa la pianificazione del recupero.
day_of_month

int32

Campo facoltativo. Il giorno del mese in cui deve essere recuperato il file dell'origine dati (1-31). Questo campo può essere impostato solo per la frequenza mensile.
time_of_day

TimeOfDay

Campo facoltativo. L'ora del giorno in cui deve essere recuperato il file dell'origine dati. I minuti e i secondi non sono supportati e verranno ignorati.
day_of_week

DayOfWeek

Campo facoltativo. Il giorno della settimana in cui deve essere recuperato il file dell'origine dati. Questo campo può essere impostato solo per la frequenza settimanale.
time_zone

string

Campo facoltativo. Fuso orario utilizzato per la pianificazione. UTC per impostazione predefinita. Ad esempio, "America/Los_Angeles".
frequency

Frequency

Obbligatoria. La frequenza che descrive la pianificazione del recupero.
fetch_uri

string

Campo facoltativo. L'URL da cui è possibile recuperare il file dell'origine dati. Google Merchant Center supporta i caricamenti automatici pianificati utilizzando i protocolli HTTP, HTTPS o SFTP, quindi il valore deve essere un link valido che utilizza uno di questi tre protocolli. Immutabile per i file di Fogli Google.
username

string

Campo facoltativo. Un nome utente facoltativo per [recupera url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. Utilizzato per inviare origini dati tramite SFTP.
password

string

Campo facoltativo. Una password facoltativa per [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. Utilizzato per inviare origini dati tramite SFTP.

Frequenza

I campi obbligatori variano in base alla frequenza del recupero. Per una pianificazione del recupero mensile, i campi [giorno del mese][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_month] e [ora del giorno][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] sono obbligatori. Per una pianificazione del recupero settimanale, i campi [giorno della settimana][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_week] e [ora del giorno][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] sono obbligatori. Per una pianificazione di recupero giornaliera, è richiesto solo un'[ora del giorno][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day].

Enum
FREQUENCY_UNSPECIFIED Frequenza non specificata.
FREQUENCY_DAILY Il recupero avviene ogni giorno.
FREQUENCY_WEEKLY Il recupero viene eseguito ogni settimana.
FREQUENCY_MONTHLY Il recupero avviene ogni mese.

FileInputType

Il metodo di invio dei file.

Enum
FILE_INPUT_TYPE_UNSPECIFIED Tipo di input del file non specificato.
UPLOAD Il file viene caricato tramite SFTP, Google Cloud Storage o manualmente in Merchant Center.
FETCH Il file viene recuperato dal metodo [fetch_uri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] configurato.
GOOGLE_SHEETS Il file viene recuperato da Fogli Google specificato in [fetch_uri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri].

GetDataSourceRequest

Messaggio di richiesta per il metodo GetDataSource.

Campi
name

string

Obbligatoria. Il nome dell'origine dati da recuperare. Formato: accounts/{account}/dataSources/{datasource}

ListDataSourcesRequest

Messaggio di richiesta per il metodo ListDataSources.

Campi
parent

string

Obbligatoria. L'account per cui elencare le origini dati. Formato: accounts/{account}
page_size

int32

Campo facoltativo. Il numero massimo di origini dati da restituire. Il servizio potrebbe restituire un valore inferiore a questo valore. Il valore massimo è 1000; i valori superiori a 1000 verranno forzati a 1000. Se non specificato, verrà restituito il numero massimo di origini dati.
page_token

string

Campo facoltativo. Un token di pagina, ricevuto da una precedente chiamata a ListDataSources. Forniscilo per recuperare la pagina successiva.

Durante l'impaginazione, tutti gli altri parametri forniti a ListDataSources devono corrispondere alla chiamata che ha fornito il token della pagina.

ListDataSourcesResponse

Messaggio di risposta per il metodo ListDataSources.

Campi
data_sources[]

DataSource

Le origini dati dell'account specificato.
next_page_token

string

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

LocalInventoryDataSource

L'origine dati dell'inventario locale.

Campi
feed_label

string

Obbligatoria. Immutabile. L'etichetta del feed delle offerte a cui viene fornito l'inventario locale.

Deve essere inferiore o uguale a 20 lettere maiuscole (A-Z), numeri (0-9) e trattini (-).

Consulta anche la pagina sulla migrazione alle etichette dei feed.
content_language

string

Obbligatoria. Immutabile. La lingua ISO 639-1 a due lettere degli articoli per i quali viene fornito l'inventario locale.

PrimaryProductDataSource

L'origine dati principale per i prodotti locali e online.

Campi
channel

Channel

Obbligatoria. Immutabile. Specifica il tipo di canale dell'origine dati.
countries[]

string

Campo facoltativo. I paesi in cui potrebbero essere visualizzati gli articoli. Rappresentato come codice di territorio CLDR.
feed_label

string

Campo facoltativo. Immutabile. L'etichetta del feed specificata a livello di origine dati.

Deve essere inferiore o uguale a 20 lettere maiuscole (A-Z), numeri (0-9) e trattini (-).

Consulta anche la pagina sulla migrazione alle etichette dei feed.

feedLabel e contentLanguage devono essere impostati o non impostati per le origini dati con tipo di contenuti del prodotto. Devono essere impostati per le origini dati con un input file.

Se impostata, l'origine dati accetterà solo i prodotti che corrispondono a questa combinazione. Se non viene configurato, l'origine dati accetterà i prodotti senza questa limitazione.
content_language

string

Campo facoltativo. Immutabile. La lingua ISO 639-1 a due lettere degli articoli nell'origine dati.

feedLabel e contentLanguage devono essere impostati o non impostati. È possibile annullare l'impostazione dei campi solo per le origini dati senza input file.

Se impostata, l'origine dati accetterà solo i prodotti che corrispondono a questa combinazione. Se non viene configurato, l'origine dati accetterà i prodotti senza questa limitazione.

Canale

Canale di origine dati.

Il canale viene utilizzato per distinguere tra origini dati per verticali di prodotti diversi.

Enum
CHANNEL_UNSPECIFIED Non specificato.
ONLINE_PRODUCTS Prodotto online.
LOCAL_PRODUCTS Prodotto locale.
PRODUCTS Origine dati unificata per prodotti locali e online.

PromotionDataSource

L'origine dati della promozione.

Campi
target_country

string

Obbligatoria. Immutabile. Il paese di destinazione utilizzato come parte dell'identificatore univoco. Rappresentato come codice di territorio CLDR.

Le promozioni sono disponibili solo in alcuni paesi.
content_language

string

Obbligatoria. Immutabile. La lingua ISO 639-1 a due lettere degli articoli nell'origine dati.

RegionalInventoryDataSource

L'origine dati dell'inventario regionale.

Campi
feed_label

string

Obbligatoria. Immutabile. L'etichetta del feed delle offerte a cui viene fornito l'inventario regionale.

Deve essere inferiore o uguale a 20 lettere maiuscole (A-Z), numeri (0-9) e trattini (-).

Consulta anche la pagina sulla migrazione alle etichette dei feed.
content_language

string

Obbligatoria. Immutabile. La lingua ISO 639-1 a due lettere degli articoli per i quali viene fornito l'inventario regionale.

SupplementalProductDataSource

L'origine dati supplementare per i prodotti locali e online.

Campi
feed_label

string

Campo facoltativo. Immutabile. L'etichetta del feed specificata a livello di origine dati.

Deve essere inferiore o uguale a 20 lettere maiuscole (A-Z), numeri (0-9) e trattini (-).

Consulta anche la pagina sulla migrazione alle etichette dei feed.

feedLabel e contentLanguage devono essere impostati o non impostati per le origini dati con tipo di contenuti del prodotto. Devono essere impostati per le origini dati con un input file.

Se impostata, l'origine dati accetterà solo i prodotti che corrispondono a questa combinazione. Se non viene configurato, l'origine dati accetterà i prodotti senza questa limitazione.
content_language

string

Campo facoltativo. Immutabile. La lingua ISO 639-1 a due lettere degli articoli nell'origine dati.

feedLabel e contentLanguage devono essere impostati o non impostati. È possibile annullare l'impostazione dei campi solo per le origini dati senza input file.

Se impostata, l'origine dati accetterà solo i prodotti che corrispondono a questa combinazione. Se non viene configurato, l'origine dati accetterà i prodotti senza questa limitazione.

UpdateDataSourceRequest

Messaggio di richiesta per il metodo UpdateDataSource.

Campi
data_source

DataSource

Obbligatoria. La risorsa dell'origine dati da aggiornare.
update_mask

FieldMask

Obbligatoria. L'elenco dei campi dell'origine dati da aggiornare.

I campi specificati nella maschera di aggiornamento senza un valore specificato nel corpo verranno eliminati dall'origine dati.

Non è possibile specificare il valore speciale "*" per la sostituzione completa dell'origine dati.