REST Resource: accounts.dataSources

Risorsa: DataSource

L'origine dati per l'account Merchant Center.

Rappresentazione JSON 
{
  "name": string,
  "dataSourceId": string,
  "displayName": string,
  "input": enum (Input),
  "fileInput": {
    object (FileInput)
  },

  // Union field Type can be only one of the following:
  "primaryProductDataSource": {
    object (PrimaryProductDataSource)
  },
  "supplementalProductDataSource": {
    object (SupplementalProductDataSource)
  },
  "localInventoryDataSource": {
    object (LocalInventoryDataSource)
  },
  "regionalInventoryDataSource": {
    object (RegionalInventoryDataSource)
  },
  "promotionDataSource": {
    object (PromotionDataSource)
  },
  "productReviewDataSource": {
    object (ProductReviewDataSource)
  },
  "merchantReviewDataSource": {
    object (MerchantReviewDataSource)
  }
  // End of list of possible types for union field Type.
}
Campi
name

string

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

string (int64 format)

Solo output. L'ID origine dati.
displayName

string

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

enum (Input)

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

object (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:
primaryProductDataSource

object (PrimaryProductDataSource)

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

object (SupplementalProductDataSource)

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

object (LocalInventoryDataSource)

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

object (RegionalInventoryDataSource)

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

object (PromotionDataSource)

Obbligatorio. L'origine dati delle promozioni.
productReviewDataSource

object (ProductReviewDataSource)

Obbligatorio. L'origine dati delle recensioni prodotto.
merchantReviewDataSource

object (MerchantReviewDataSource)

Obbligatorio. L'origine dati delle recensioni sul commerciante.

PrimaryProductDataSource

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

Rappresentazione JSON 
{
  "channel": enum (Channel),
  "countries": [
    string
  ],
  "defaultRule": {
    object (DefaultRule)
  },
  "feedLabel": string,
  "contentLanguage": string
}
Campi
channel

enum (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.
defaultRule

object (DefaultRule)

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

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 sezione 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 impostate 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.
contentLanguage

string

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

feedLabel e contentLanguage devono essere entrambi impostati o entrambi non impostati. I campi possono essere deselezionati 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.

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.

Rappresentazione JSON 
{
  "takeFromDataSources": [
    {
      object (DataSourceReference)
    }
  ]
}
Campi
takeFromDataSources[]

object (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 l'elenco seguente: [1001, self], verranno utilizzati i valori dell'attributo dall'origine dati supplementare 1001 e verrà utilizzato self se l'attributo non è impostato in 1001.

DataSourceReference

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

Rappresentazione JSON 
{

  // Union field data_source_id can be only one of the following:
  "self": boolean,
  "primaryDataSourceName": string,
  "supplementalDataSourceName": string
  // End of list of possible types for union field data_source_id.
}
Campi

Campo unione data_source_id.

data_source_id può essere solo uno dei seguenti:
self

boolean

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

string

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

string

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

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.

Rappresentazione JSON 
{
  "referencingPrimaryDataSources": [
    {
      object (DataSourceReference)
    }
  ],
  "feedLabel": string,
  "contentLanguage": string
}
Campi
referencingPrimaryDataSources[]

object (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.
feedLabel

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 sezione 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. I campi non devono essere impostati per le origini dati senza file input.

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

string

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

feedLabel e contentLanguage devono essere entrambi impostati o entrambi non impostati. I campi possono essere deselezionati 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.

LocalInventoryDataSource

L'origine dati dell'inventario locale.

Rappresentazione JSON 
{
  "feedLabel": string,
  "contentLanguage": string
}
Campi
feedLabel

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

string

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

RegionalInventoryDataSource

L'origine dati dell'inventario regionale.

Rappresentazione JSON 
{
  "feedLabel": string,
  "contentLanguage": string
}
Campi
feedLabel

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

string

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

PromotionDataSource

L'origine dati delle promozioni.

Rappresentazione JSON 
{
  "targetCountry": string,
  "contentLanguage": string
}
Campi
targetCountry

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

string

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

ProductReviewDataSource

Questo tipo non contiene campi.

L'origine dati delle recensioni prodotto.

MerchantReviewDataSource

Questo tipo non contiene campi.

L'origine dati delle recensioni del 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 attivato o disattivato tramite il bundle Account.

FileInput

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

Rappresentazione JSON 
{
  "fetchSettings": {
    object (FetchSettings)
  },
  "fileName": string,
  "fileInputType": enum (FileInputType)
}
Campi
fetchSettings

object (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.
fileName

string

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

enum (FileInputType)

Solo output. Il tipo di file inserito.

FetchSettings

Recupera i dettagli per fornire l'origine dati.

Rappresentazione JSON 
{
  "enabled": boolean,
  "dayOfMonth": integer,
  "timeOfDay": {
    object (TimeOfDay)
  },
  "dayOfWeek": enum (DayOfWeek),
  "timeZone": string,
  "frequency": enum (Frequency),
  "fetchUri": string,
  "username": string,
  "password": string
}
Campi
enabled

boolean

Facoltativo. Attiva o mette in pausa la pianificazione del recupero.
dayOfMonth

integer

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

object (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.
dayOfWeek

enum (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.
timeZone

string

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

enum (Frequency)

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

string

Facoltativo. L'URL da cui è possibile recuperare il file dell'origine dati. Google Merchant Center supporta i caricamenti pianificati automatici 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 fetchUri. Utilizzato per inviare le origini dati tramite SFTP.
password

string

Facoltativo. Una password facoltativa per fetchUri. Utilizzato per inviare le origini dati tramite SFTP.

TimeOfDay

Rappresenta un'ora del giorno. La data e il fuso orario non sono significativi o sono specificati altrove. Un'API può scegliere di consentire i secondi intercalari. I tipi correlati sono google.type.Date e google.protobuf.Timestamp.

Rappresentazione JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Campi
hours

integer

Ore di un giorno nel formato 24 ore. Deve essere maggiore o uguale a 0 e in genere deve essere minore o uguale a 23. Un'API potrebbe scegliere di consentire il valore "24:00:00" per scenari come l'orario di chiusura dell'attività.
minutes

integer

Minuti di un'ora. Deve essere maggiore o uguale a 0 e minore o uguale a 59.
seconds

integer

Secondi di un minuto. Deve essere maggiore o uguale a 0 e in genere deve essere minore o uguale a 59. Un'API potrebbe consentire il valore 60 se consente i secondi intercalari.
nanos

integer

Frazioni di secondo, in nanosecondi. Deve essere maggiore o uguale a 0 e minore o uguale a 999.999.999.

DayOfWeek

Rappresenta un giorno della settimana.

Enum
DAY_OF_WEEK_UNSPECIFIED Il giorno della settimana non è specificato.
MONDAY Lunedì
TUESDAY Martedì
WEDNESDAY Mercoledì
THURSDAY Giovedì
FRIDAY Venerdì
SATURDAY Sabato
SUNDAY Domenica

Frequenza

I campi obbligatori variano in base alla frequenza di recupero. Per una pianificazione del recupero mensile, sono obbligatori [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]. Per una pianificazione del recupero settimanale, sono obbligatori [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]. 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 file non specificato.
UPLOAD Il file viene caricato tramite SFTP, Google Cloud Storage o manualmente in Merchant Center.
FETCH Il file viene recuperato dal fetchUri configurato.
GOOGLE_SHEETS Il file viene recuperato da Fogli Google specificato in fetchUri.

Metodi

create

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

delete

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

fetch

 Esegue il recupero dei dati immediatamente (anche al di fuori della pianificazione del recupero) in un'origine dati del tuo account Merchant Center.

get

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

list

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

patch

 Aggiorna la configurazione dell'origine dati esistente.