- Risorsa: DataSource
- PrimaryProductDataSource
- Canale
- SupplementalProductDataSource
- LocalInventoryDataSource
- RegionalInventoryDataSource
- PromotionDataSource
- Ingresso
- FileInput
- FetchSettings
- TimeOfDay
- DayOfWeek
- Frequenza
- FileInputType
- Metodi
Risorsa: DataSource
L'origine dati dell'account Merchant Center.
Rappresentazione JSON |
---|
{ "name": string, "dataSourceId": string, "displayName": string, "input": enum ( |
Campi | |
---|---|
name |
Identificatore. Il nome dell'origine dati. Formato: |
dataSourceId |
Solo output. L'ID origine dati. |
displayName |
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. |
fileInput |
(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 |
Obbligatorio. L'origine dati principale per i prodotti locali e online. |
supplementalProductDataSource |
Obbligatorio. L'origine dati supplementare per i prodotti locali e online. |
localInventoryDataSource |
Obbligatorio. L'origine dati inventario locale. |
regionalInventoryDataSource |
Obbligatorio. L'origine dati inventario regionale. |
promotionDataSource |
Obbligatorio. L'origine dati della promozione. |
PrimaryProductDataSource
L'origine dati principale per i prodotti locali e online.
Rappresentazione JSON |
---|
{
"channel": enum ( |
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. |
feedLabel |
(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. |
contentLanguage |
(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. |
SupplementalProductDataSource
L'origine dati supplementare per i prodotti locali e online.
Rappresentazione JSON |
---|
{ "feedLabel": string, "contentLanguage": string } |
Campi | |
---|---|
feedLabel |
(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. |
contentLanguage |
(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. |
LocalInventoryDataSource
L'origine dati dell'inventario locale.
Rappresentazione JSON |
---|
{ "feedLabel": string, "contentLanguage": string } |
Campi | |
---|---|
feedLabel |
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. |
contentLanguage |
Obbligatorio. 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 |
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. |
contentLanguage |
Obbligatorio. 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 |
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 |
Obbligatorio. Immutabile. La lingua ISO 639-1 a due lettere degli articoli nell'origine dati. |
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 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 ( |
Campi | |
---|---|
fetchSettings |
(Facoltativo) Recupera i dettagli per pubblicare l'origine dati. Contiene le impostazioni per i tipi di input di file |
fileName |
(Facoltativo) Il nome file dell'origine dati. Obbligatorio per il tipo di input file |
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 ( |
Campi | |
---|---|
enabled |
(Facoltativo) Attiva o mette in pausa la pianificazione del recupero. |
dayOfMonth |
(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 |
(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 |
(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 |
(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. |
fetchUri |
(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 [recupera 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 |
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 |
Minuti dell'ora del giorno. Il valore deve essere compreso tra 0 e 59. |
seconds |
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 |
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 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 [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 |
|
---|---|
|
Crea la nuova configurazione dell'origine dati per l'account specificato. |
|
Consente di eliminare un'origine dati dal tuo account Merchant Center. |
|
Esegue immediatamente il recupero dei dati (anche al di fuori della pianificazione del recupero) su un'origine dati dal tuo account Merchant Center. |
|
Recupera la configurazione dell'origine dati per l'account specificato. |
|
Elenca le configurazioni delle origini dati per l'account specificato. |
|
Aggiorna la configurazione dell'origine dati esistente. |