Questa pagina mostra come creare e aggiornare in modo programmatico le origini dati che ti consentono di inserire i prodotti. Dati automatizzati fonti semplificano l'invio i tuoi dati di prodotto a Google. Le origini dati automatizzate assicurano che informazioni aggiornate sui prodotti pertinenti del tuo sito web raggiungono Google.
L'API Content for Shopping ti consente di creare solo origini dati principali. Con L'API Merchant Data Source, puoi creare i seguenti tipi di origini dati:
- Origini dei dati di prodotto principali
- Origini dati di prodotto supplementari
- Origini dati dell'inventario locale
- Origini dati dell'inventario regionale
- Origini dati delle promozioni
L'API Content for Shopping consentiva di gestire soltanto le origini dati con input di file. L'API Merchant ti consente di gestire le origini dati con input sia di file che API.
Con l'API Merchant Data origini puoi:
- Crea una nuova origine dati principale con
feedLabel
e uno specificocontentLanguage
. - Creare un'origine dati con caratteri jolly. Un'origine dati con caratteri jolly non ha
feedLabel
econtentLanguage
impostati. Le origini dati con caratteri jolly consentono di inserire di prodotti con diverse combinazioni difeedLabel
econtentLanguage
in un'origine dati. - Crea un'origine dati supplementare da collegare a un'origine dati principale esistente.
- Configura una pianificazione per un'origine dati file.
- Registra il tuo account per la gestione automatica delle origini dati.
- Gestisci le origini dati delle API.
- Gestisci la regola predefinita delle origini dati utilizzando le origini dati di prodotto principali.
- Utilizzare altri tipi di origini dati, come le promozioni.
Prerequisiti
- Devi aver eseguito la migrazione del tuo account a singoli feed con impostazioni internazionali.
Per verificare che sia già stata eseguita la migrazione dell'account alla suddivisione del target dei dati, utilizza la l'elenco delle origini dati o i metodi get. Nel caso in cui tu non abbia l'idoneità, riceverai il seguente messaggio di eccezione e dovresti contattare l'assistenza.
This account is in the data sources migration process and can't be used with this API yet. Contact support for more info on when this account will be able to use the data sources endpoint.
Creare una nuova origine dati
Per creare una nuova origine dati principale con feedLabel
e uno specifico
contentLanguage
, imposta i campi feedLabel
e contentLanguage
nel
configurazione specifica per il tipo. Ad esempio, PrimaryProductDataSource
.
Per visualizzare l'origine dati appena creata, crea una richiesta GET
o LIST
.
Crea una nuova origine dati principale con caratteri jolly
Per creare un nuovo feed principale con caratteri jolly, configura l'origine dati utilizzando
PrimaryProductDataSource
e non impostare i campi feedLabel
e contentLanguage
.
Se utilizzi l'API Content for Shopping, è stata creata una sola origine dati API per te. Se utilizzi l'API Merchant Data Origini dati del commerciante, puoi avere più origini dati dell'API, alcuni dei quali possono essere caratteri jolly.
Solo le origini dati con input API possono essere origini dati con caratteri jolly. Dati jolly Le origini dati non sono supportate per gli input dei file.
Crea un'origine dati supplementare e collegala all'origine dati principale
Puoi utilizzare origini dati supplementari per apportare aggiornamenti parziali ai dati di prodotto:
aggiungendo l'identificatore univoco dell'origine dati come parametro di query quando si effettua
chiamate al
accounts.productInputs.insert
e
accounts.productInputs.delete
di machine learning. Puoi utilizzare origini dati supplementari solo per aggiornare i prodotti esistenti.
Per creare un'origine dati supplementare, configura l'origine dati utilizzando
SupplementalProductDataSource
e poi collegalo aggiornando defaultRule
nell'origine dati principale.
Le origini dati file supplementari non possono essere origini dati con caratteri jolly. API supplementare Le origini dati devono sempre essere origini dati con caratteri jolly.
Configurare una pianificazione per l'origine dati dei file
Per impostare una pianificazione per il feed di file, configura l'origine dati in modo che sia un file
utilizzando il campo FileInput
e poi configura
fetchsettings
utilizzando il campo FileInput.FetchSettings
.
Eliminare un'origine dati
Per eliminare un'origine dati esistente dal tuo account, utilizza la
accounts.dataSources.delete
.
Recupera origine dati
Per recuperare un file configurato nell'origine dati, utilizza il metodo
accounts.dataSources.fetch
. Questo metodo esegue il recupero dei dati immediatamente su un'origine dati da
al tuo account. Questo metodo funziona solo sulle origini dati con un set di input file.
Recupera origine dati
Per recuperare la configurazione dell'origine dati per il tuo account, utilizza il metodo
accounts.dataSources.get
.
Elenco origine dati
Per elencare le configurazioni per le origini dati per il tuo account, utilizza la
accounts.dataSources.list
.
Patch origine dati
Per aggiornare la configurazione di un'origine dati esistente, utilizza il metodo
accounts.dataSources.patch
.
Collega origini dati
Le origini dei dati di prodotto principali ti consentono di gestire le origini predefinite regola delle origini dati. La regola predefinita è la regola che si applica a tutti attributi della tua origine dati. È possibile impostare la regola predefinita durante la creazione oppure aggiornandone una esistente tramite la regola predefinita. .
La seguente configurazione di esempio garantisce che tutti gli attributi vengano prima acquisiti
dall'origine dati con l'identificatore univoco 1001
. Poi l'elemento mancante
vengono aggiunti dall'origine dati principale. Alla fine, i restanti
verranno presi dall'origine dati supplementare con l'attributo
l'identificatore 1002
, se non è già fornito in altre origini dati. Se lo stesso
viene fornito in più origini dati, il valore più alto nell'elenco è
selezionato.
defaultRule {
takeFromDataSources: [
'1001', // Supplemental product data source
'self', // Self reference to the primary data source
'1002' // Supplemental product data source
]
}
Gestione automatica dei feed
Per registrare il tuo account per la gestione automatica delle origini dati, devi eseguire le seguenti operazioni: seguenti:
- Verifica se il tuo account è idoneo per la registrazione chiamando il
Accounts.AutofeedSettings.Get
. - Assicurati che il tuo account non sia un marketplace Google Cloud.
Quando il tuo account risulta idoneo per la registrazione, puoi utilizzare
Metodo Accounts.AutofeedSettings.Update
per attivare la gestione automatica dei dati
fonti. L'attivazione della gestione automatica delle origini dati consente a Google
aggiungi i tuoi prodotti dal tuo negozio online e assicurati che siano sempre aggiornati
sulle piattaforme di Google.
Recuperare lo stato di caricamento del file
Per conoscere lo stato di un'origine dati tra file, recupero o foglio di lavoro, devi
può chiamare il metodo GET
del servizio FileUpload
. Per ottenere il risultato
l'ultimo recupero dell'origine dati
calcolato in modo asincrono quando
l'elaborazione dell'origine è terminata. Utilizza l'identificatore del nome latest
.
GET https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/datasources/{datasourceId}/fileUploads/latest
Lo stato di caricamento del file potrebbe contenere una visualizzazione dettagliata dei tuoi prodotti, tra cui: potenziali problemi.
Tieni presente che lo stato di caricamento del file potrebbe non esistere se il file non è mai stato caricato. Lo stato di caricamento file potrebbe essere in stato di elaborazione, se richiesto subito dopo viene caricato il file.