Indice
DataSourcesService
(interfaccia)CreateDataSourceRequest
(messaggio)DataSource
(messaggio)DataSource.Input
(enum)DeleteDataSourceRequest
(messaggio)FetchDataSourceRequest
(messaggio)FileInput
(messaggio)FileInput.FetchSettings
(messaggio)FileInput.FetchSettings.Frequency
(enum)FileInput.FileInputType
(enum)GetDataSourceRequest
(messaggio)ListDataSourcesRequest
(messaggio)ListDataSourcesResponse
(messaggio)LocalInventoryDataSource
(messaggio)PrimaryProductDataSource
(messaggio)PrimaryProductDataSource.Channel
(enum)PromotionDataSource
(messaggio)RegionalInventoryDataSource
(messaggio)SupplementalProductDataSource
(messaggio)UpdateDataSourceRequest
(messaggio)
DataSourcesService
Servizio per la gestione di principali, supplementari, inventari e altre origini dati. Scopri di più nell'articolo del Centro assistenza Merchant Center.
CreateDataSource |
---|
Crea la nuova configurazione dell'origine dati per l'account specificato.
|
DeleteDataSource |
---|
Consente di eliminare un'origine dati dal tuo account Merchant Center.
|
FetchDataSource |
---|
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.
|
GetDataSource |
---|
Recupera la configurazione dell'origine dati per l'account specificato.
|
ListDataSources |
---|
Elenca le configurazioni delle origini dati per l'account specificato.
|
UpdateDataSource |
---|
Aggiorna la configurazione dell'origine dati esistente. I campi impostati nella maschera di aggiornamento, ma non forniti nella risorsa, verranno eliminati.
|
CreateDataSourceRequest
Messaggio di richiesta per il metodo CreateDataSource.
Campi | |
---|---|
parent |
Obbligatorio. L'account in cui verrà creata l'origine dati. Formato: |
data_source |
Obbligatorio. L'origine dati da creare. |
Origine dati
L'origine dati dell'account Merchant Center.
Campi | |
---|---|
name |
Identificatore. Il nome dell'origine dati. Formato: |
data_source_id |
Solo output. L'ID origine dati. |
display_name |
Obbligatorio. Il nome dell'origine dati visualizzato nell'interfaccia utente di Merchant Center. |
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 |
(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 |
Obbligatorio. L'origine dati principale per i prodotti locali e online. |
supplemental_product_data_source |
Obbligatorio. L'origine dati supplementare per i prodotti locali e online. |
local_inventory_data_source |
Obbligatorio. L'origine dati inventario locale. |
regional_inventory_data_source |
Obbligatorio. L'origine dati inventario regionale. |
promotion_data_source |
Obbligatorio. L'origine dati della promozione. |
Input
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 |
Sono noti anche come feed automatici, utilizzati 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 |
Obbligatorio. Il nome dell'origine dati da eliminare. Formato: |
FetchDataSourceRequest
Messaggio di richiesta per il metodo FetchDataSource.
Campi | |
---|---|
name |
Obbligatorio. Il nome della risorsa dell'origine dati da recuperare. Formato: |
FileInput
I dati specifici per le origini dati dei file. Questo campo è vuoto per altri input dell'origine dati.
Campi | |
---|---|
fetch_settings |
(Facoltativo) Recupera i dettagli per pubblicare l'origine dati. Contiene le impostazioni per i tipi di input di file |
file_name |
(Facoltativo) Il nome file dell'origine dati. Obbligatorio per il tipo di input file |
file_input_type |
Solo output. Il tipo di file di input. |
FetchSettings
Recupera i dettagli per pubblicare l'origine dati.
Campi | |
---|---|
enabled |
(Facoltativo) Attiva o mette in pausa la pianificazione del recupero. |
day_of_month |
(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 |
(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 |
(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 |
(Facoltativo) Fuso orario utilizzato per la pianificazione. UTC per impostazione predefinita. Ad esempio, "America/Los_Angeles". |
frequency |
Obbligatorio. La frequenza che descrive la pianificazione del recupero. |
fetch_uri |
(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 |
(Facoltativo) Un nome utente facoltativo per [recupera url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. Utilizzato per inviare origini dati tramite SFTP. |
password |
(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 programmazione 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 programmazione 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 programmazione del 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 |
Obbligatorio. Il nome dell'origine dati da recuperare. Formato: |
ListDataSourcesRequest
Messaggio di richiesta per il metodo ListDataSources.
Campi | |
---|---|
parent |
Obbligatorio. L'account per cui elencare le origini dati. Formato: |
page_size |
(Facoltativo) Il numero massimo di origini dati da restituire. Il servizio potrebbe restituire un valore inferiore a questo valore. Il valore massimo è 1000; valori superiori a 1000 verranno forzati a 1000. Se non specificato, verrà restituito il numero massimo di origini dati. |
page_token |
(Facoltativo) Un token di pagina, ricevuto da una precedente chiamata a Durante l'impaginazione, tutti gli altri parametri forniti a |
ListDataSourcesResponse
Messaggio di risposta per il metodo ListDataSources.
Campi | |
---|---|
data_sources[] |
Le origini dati dell'account specificato. |
next_page_token |
Un token, che può essere inviato come |
LocalInventoryDataSource
L'origine dati dell'inventario locale.
Campi | |
---|---|
feed_label |
Obbligatorio. 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 |
Obbligatorio. 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 |
Obbligatorio. Immutabile. Specifica il tipo di canale dell'origine dati. |
countries[] |
(Facoltativo) I paesi in cui potrebbero essere visualizzati gli articoli. Rappresentato come codice di territorio CLDR. |
feed_label |
(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.
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 |
(Facoltativo) Immutabile. La lingua ISO 639-1 a due lettere degli articoli nell'origine dati.
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. Nota: la gestione dei prodotti tramite l'API non è possibile per questo canale. |
PromotionDataSource
L'origine dati della promozione.
Campi | |
---|---|
target_country |
Obbligatorio. 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 |
Obbligatorio. Immutabile. La lingua ISO 639-1 a due lettere degli articoli nell'origine dati. |
RegionalInventoryDataSource
L'origine dati dell'inventario regionale.
Campi | |
---|---|
feed_label |
Obbligatorio. 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 |
Obbligatorio. 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 |
(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.
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 |
(Facoltativo) Immutabile. La lingua ISO 639-1 a due lettere degli articoli nell'origine dati.
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 |
Obbligatorio. La risorsa dell'origine dati da aggiornare. |
update_mask |
Obbligatorio. 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. L'indicazione speciale "*" per la sostituzione completa dell'origine dati non è supportato. |