Package google.shopping.merchant.datasources.v1beta

Indice

DataSourcesService

Servizio per gestire origini dati principali, supplementari, di inventario e altre. 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 devi chiamare questo metodo più di una volta al giorno, ti consigliamo di utilizzare il servizio Prodotti per aggiornare i dati di prodotto. Questo metodo funziona solo con le 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.

FileUploadsService

Servizio per gestire i caricamenti dei file delle origini dati.

GetFileUpload

rpc GetFileUpload(GetFileUploadRequest) returns (FileUpload)

Recupera il caricamento del file dell'origine dati più recente. Per il caricamento di un file è accettato solo l'alias latest.

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

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

DataSource

Obbligatorio. L'origine dati da creare.

Origine dati

L'origine dati per l'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

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

Input

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

FileInput

(Facoltativo) Il campo viene utilizzato solo quando i dati vengono gestiti tramite un file.
Campo unione Type. Il tipo di origine dati. Type può essere solo uno dei seguenti:
primary_product_data_source

PrimaryProductDataSource

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

SupplementalProductDataSource

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

LocalInventoryDataSource

Obbligatorio. L'origine dati dell'inventario locale.
regional_inventory_data_source

RegionalInventoryDataSource

Obbligatorio. L'origine dati dell'inventario regionale.
promotion_data_source

PromotionDataSource

Obbligatorio. L'origine dati promozione.
product_review_data_source

ProductReviewDataSource

Obbligatorio. L'origine dati delle recensioni prodotto.
merchant_review_data_source

MerchantReviewDataSource

Obbligatorio. L'origine dati delle recensioni sul commerciante.

Input

Determina il tipo di input all'origine dati. A seconda dell'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 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 creato o aggiornato tramite questa API, ma solo tramite l'interfaccia utente di Merchant Center.

Questo tipo di origine dati è di sola lettura.
AUTOFEED Sono noti anche come feed automatici e vengono utilizzati per creare automaticamente i dati di prodotto. Questo tipo di origine dati può essere attivata o disattivata tramite il bundle Account.

DataSourceReference

Il riferimento all'origine dati può essere utilizzato per gestire le origini dati correlate all'interno del servizio delle origini dati.

Campi

Campo unione data_source_id.

data_source_id può essere solo uno dei seguenti:
self

bool

Self deve essere utilizzato per fare riferimento all'origine dati principale stessa.
primary_data_source_name

string

(Facoltativo) Il nome dell'origine dati principale. Formato: accounts/{account}/dataSources/{datasource}
supplemental_data_source_name

string

(Facoltativo) Il nome dell'origine dati supplementare. Formato: accounts/{account}/dataSources/{datasource}

DeleteDataSourceRequest

Messaggio di richiesta per il metodo DeleteDataSource.

Campi
name

string

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

FetchDataSourceRequest

Messaggio di richiesta per il metodo FetchDataSource.

Campi
name

string

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

FileInput

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

Campi
fetch_settings

FetchSettings

(Facoltativo) Recupera i dettagli per fornire l'origine dati. Contiene le impostazioni per i tipi di input dei file FETCH e GOOGLE_SHEETS. I campi obbligatori variano in base alla frequenza di recupero.
file_name

string

(Facoltativo) Il nome del file dell'origine dati. Obbligatorio per il tipo di input file UPLOAD.
file_input_type

FileInputType

Solo output. Il tipo di file inserito.

FetchSettings

Recupera i dettagli per fornire l'origine dati.

Campi
enabled

bool

(Facoltativo) Attiva o mette in pausa la pianificazione del recupero.
day_of_month

int32

(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

(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

(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

(Facoltativo) Fuso orario utilizzato per la pianificazione. UTC per impostazione predefinita. Ad esempio, "America/Los_Angeles".
frequency

Frequency

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

string

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

string

(Facoltativo) Un nome utente facoltativo per [URL di recupero][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. Utilizzato per inviare le origini dati tramite SFTP.
password

string

(Facoltativo) Una password facoltativa per [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. Utilizzato per inviare le origini dati tramite SFTP.

Frequenza

I campi obbligatori variano in base alla frequenza di 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 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 pianificazione del recupero giornaliera, è necessaria 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 avviene ogni settimana.
FREQUENCY_MONTHLY Il recupero avviene ogni mese.

FileInputType

Il metodo di caricamento 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 da [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].

FileUpload

Il caricamento del file di un'origine dati specifica, ovvero il risultato del recupero dell'origine dati in un determinato timestamp calcolato in modo asincrono al termine dell'elaborazione dell'origine dati. Il problema riguarda solo le origini dati dei file.

Campi
name

string

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

int64

Solo output. L'ID origine dati.
processing_state

ProcessingState

Solo output. Lo stato di elaborazione dell'origine dati.
issues[]

Issue

Solo output. L'elenco dei problemi che si verificano nell'origine dati.
items_total

int64

Solo output. Il numero di elementi nell'origine dati che sono stati elaborati.
items_created

int64

Solo output. Il numero di elementi creati nell'origine dati.
items_updated

int64

Solo output. Il numero di elementi nell'origine dati che sono stati aggiornati.
upload_time

Timestamp

Solo output. La data in cui è stato caricato il file dell'origine dati.

Problema

Un errore che si verifica nell'origine dati, ad esempio "prezzo non valido".

Campi
title

string

Solo output. Il titolo del problema, ad esempio "Articolo troppo grande".
description

string

Solo output. La descrizione dell'errore, ad esempio: "L'origine dati contiene articoli con troppi attributi o di dimensioni troppo grandi. Questi elementi verranno eliminati".
code

string

Solo output. Il codice dell'errore, ad esempio "validation/invalid_value". Restituisce "?" se il codice è sconosciuto.
count

int64

Solo output. Il numero di occorrenze dell'errore nel caricamento del file.
severity

Severity

Solo output. La gravità del problema.
documentation_uri

string

Solo output. Link alla documentazione che spiega il problema in modo più dettagliato, se disponibile.

Gravità

La gravità del problema.

Enum
SEVERITY_UNSPECIFIED Gravità non specificata.
WARNING Il problema è l'avviso.
ERROR Il problema è un errore.

ProcessingState

Lo stato di elaborazione dell'origine dati.

Enum
PROCESSING_STATE_UNSPECIFIED Stato di elaborazione non specificato.
FAILED L'origine dati non è stata elaborata o tutti gli elementi contenevano errori.
IN_PROGRESS L'origine dati è in fase di elaborazione.
SUCCEEDED L'origine dati è stata elaborata correttamente, anche se alcuni elementi potrebbero aver generato errori.

GetDataSourceRequest

Messaggio di richiesta per il metodo GetDataSource.

Campi
name

string

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

GetFileUploadRequest

Messaggio di richiesta per il metodo GetFileUploadRequest.

Campi
name

string

Obbligatorio. Il nome del file dell'origine dati da recuperare. Formato: accounts/{account}/dataSources/{datasource}/fileUploads/latest

ListDataSourcesRequest

Messaggio di richiesta per il metodo ListDataSources.

Campi
parent

string

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

int32

(Facoltativo) Il numero massimo di origini dati da restituire. Il servizio potrebbe restituire meno di 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

(Facoltativo) Un token di pagina ricevuto da una chiamata ListDataSources precedente. Fornisci questo valore per recuperare la pagina successiva.

Quando viene applicata la paginazione, tutti gli altri parametri forniti a ListDataSources devono corrispondere alla chiamata che ha fornito il token 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

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

Deve contenere meno di 20 lettere maiuscole (A-Z), numeri (0-9) e trattini (-).

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

string

Obbligatorio. Immutabile. La lingua ISO 639-1 di due lettere degli articoli a cui viene fornito l'inventario locale.

MerchantReviewDataSource

Questo tipo non contiene campi.

L'origine dati delle recensioni del commerciante.

PrimaryProductDataSource

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

Campi
channel

Channel

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

string

(Facoltativo) I paesi in cui gli articoli potrebbero essere visualizzati. Rappresentato come codice di territorio CLDR.
default_rule

DefaultRule

(Facoltativo) Gestione delle regole predefinite dell'origine dati. Se impostato, le origini dati collegate verranno sostituite.
feed_label

string

(Facoltativo) Immutabile. L'etichetta del feed specificata a livello di origine dati.

Deve contenere meno di 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 entrambi 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 impostato, l'origine dati accetterà solo i prodotti corrispondenti a questa combinazione. Se non impostato, l'origine dati accetterà i prodotti senza questa limitazione.
content_language

string

(Facoltativo) Immutabile. La lingua ISO 639-1 di due lettere degli elementi dell'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 impostato, l'origine dati accetterà solo i prodotti corrispondenti a questa combinazione. Se non viene configurato, l'origine dati accetterà i prodotti senza questa limitazione.

Canale

Canale dell'origine dati.

Il canale viene utilizzato per distinguere le origini dati per diversi verticali di prodotto.

Enum
CHANNEL_UNSPECIFIED Non specificato.
ONLINE_PRODUCTS Prodotto online.
LOCAL_PRODUCTS Prodotto locale.
PRODUCTS Origine dati unificata sia per i prodotti locali che per quelli online. Nota: la gestione dei prodotti tramite l'API non è possibile per questo canale.

DefaultRule

Gestione delle regole predefinite dell'origine dati.

Campi
take_from_data_sources[]

DataSourceReference

Obbligatorio. L'elenco delle origini dati collegate nella regola predefinita. Questo elenco è ordinato in base alla priorità della regola predefinita per l'unione dei dati. Potrebbe non includere alcun riferimento o più riferimenti a self e alle origini dati supplementari.

L'elenco non deve essere vuoto.

Per collegare l'origine dati alla regola predefinita, devi aggiungere un nuovo riferimento a questo elenco (in ordine sequenziale).

Per scollegare l'origine dati dalla regola predefinita, devi rimuovere il riferimento specificato da questo elenco.

La modifica dell'ordine di questo elenco comporta la modifica della priorità delle origini dati nella regola predefinita.

Ad esempio, se fornisci il seguente elenco: [1001, self], i valori degli attributi verranno recuperati dall'origine dati supplementare 1001 e il valore di riserva sarà self se l'attributo non è impostato in 1001.

ProductReviewDataSource

Questo tipo non contiene campi.

L'origine dati delle recensioni prodotto.

PromotionDataSource

L'origine dati della promozione.

Campi
target_country

string

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

string

Obbligatorio. Immutabile. La lingua ISO 639-1 di due lettere degli elementi dell'origine dati.

RegionalInventoryDataSource

L'origine dati dell'inventario regionale.

Campi
feed_label

string

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

Deve contenere meno di 20 lettere maiuscole (A-Z), numeri (0-9) e trattini (-).

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

string

Obbligatorio. Immutabile. La lingua ISO 639-1 di due lettere degli articoli a cui viene fornito l'inventario regionale.

SupplementalProductDataSource

L'origine dati supplementare per i prodotti locali e online. Dopo la creazione, assicurati di collegare l'origine dati di prodotto supplementare a una o più origini dati di prodotto principali.

Campi
referencing_primary_data_sources[]

DataSourceReference

Solo output. L'elenco (non ordinato e deduplicato) di tutte le origini dati principali collegate a questa origine dati nelle regole predefinite o personalizzate. L'origine dati supplementare non può essere eliminata prima che tutti i link vengano rimossi.
feed_label

string

(Facoltativo) Immutabile. L'etichetta del feed specificata a livello di origine dati.

Deve contenere meno di 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 entrambi impostati o non impostati per le origini dati con tipo di contenuti del prodotto.

Devono essere impostati per le origini dati con un file input. Non è necessario configurare i campi per le origini dati senza file input.

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

string

(Facoltativo) Immutabile. La lingua ISO 639-1 di due lettere degli elementi dell'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 impostato, l'origine dati accetterà solo i prodotti corrispondenti a questa combinazione. Se non impostato, l'origine dati accetterà i prodotti senza questa limitazione.

UpdateDataSourceRequest

Messaggio di richiesta per il metodo UpdateDataSource.

Campi
data_source

DataSource

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

FieldMask

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.

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