REST Resource: accounts.dataSources

Risorsa: DataSource

L'origine dati dell'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)
  }
  // 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

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

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

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

object (PrimaryProductDataSource)

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

object (SupplementalProductDataSource)

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

object (LocalInventoryDataSource)

Obbligatoria. L'origine dati inventario locale.
regionalInventoryDataSource

object (RegionalInventoryDataSource)

Obbligatoria. L'origine dati inventario regionale.
promotionDataSource

object (PromotionDataSource)

Obbligatoria. L'origine dati della promozione.

PrimaryProductDataSource

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

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

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

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

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.

SupplementalProductDataSource

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

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

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

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.

LocalInventoryDataSource

L'origine dati dell'inventario locale.

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

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

string

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

RegionalInventoryDataSource

L'origine dati dell'inventario regionale.

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

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

string

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

PromotionDataSource

L'origine dati della promozione.

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

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

string

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

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.

FileInput

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

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

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

string

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

enum (FileInputType)

Solo output. Il tipo di file di input.

FetchSettings

Recupera i dettagli per pubblicare 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

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

integer

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

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

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

string

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

enum (Frequency)

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

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.

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

Le ore del giorno nel formato 24 ore. Deve essere compreso tra 0 e 23. Un'API può scegliere di consentire il valore "24:00:00" per scenari come l'orario di chiusura dell'attività.
minutes

integer

Minuti dell'ora del giorno. Il valore deve essere compreso tra 0 e 59.
seconds

integer

Secondi di minuti del tempo. Normalmente deve essere compreso tra 0 e 59. Un'API potrebbe consentire il valore 60 se consente i secondi intercalari.
nanos

integer

Frazioni di secondi in nanosecondi. Deve essere compreso tra 0 e 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 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 [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] configurato.
GOOGLE_SHEETS Il file viene recuperato da Fogli Google specificato in [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri].

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 immediatamente il recupero dei dati (anche al di fuori della pianificazione del recupero) su un'origine dati dal 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.