Questa pagina mostra come creare e aggiornare in modo programmatico le origini dati che consentono di inserire i prodotti. Le origini dati automatizzate semplificano l'invio dei dati di prodotto a Google. Le origini dati automatiche assicurano che le informazioni più aggiornate sui prodotti pertinenti del tuo sito web raggiungano Google.
L'API Content for Shopping ti consente di creare solo origini dati principali. Con l'API Merchant Data origini, 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
econtentLanguage
specifici. - Creare un'origine dati con caratteri jolly. In un'origine dati con caratteri jolly non sono impostati i campi
feedLabel
econtentLanguage
. Le origini dati con caratteri jolly consentono di inserire 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.
- Gestisci le origini dati delle API.
- 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 l'elenco delle origini dati o i metodi get. Se non soddisfi i requisiti di idoneità, riceverai il seguente messaggio di eccezione e dovrai 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
contentLanguage
specifici, imposta i campi feedLabel
e contentLanguage
nella
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
.
Con l'API Content for Shopping, viene creata una sola origine dati API. Se utilizzi l'API Merchant Data origini, puoi avere più origini dati dell'API, alcune delle quali possono essere caratteri jolly.
Solo le origini dati con input API possono essere origini dati con caratteri jolly. Le origini dati con caratteri jolly non sono supportate per l'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 effettui chiamate ai metodi
accounts.productInputs.insert
e
accounts.productInputs.delete
. 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 collegala aggiornando il campo defaultRule
nell'origine dati principale.
Le origini dati file supplementari non possono essere origini dati con caratteri jolly. Le origini dati API supplementari 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'origine dati del file utilizzando il campo FileInput
, poi configura
fetchsettings
utilizzando il campo FileInput.FetchSettings
.
Eliminare un'origine dati
Per eliminare un'origine dati esistente dal tuo account, utilizza il metodo 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 dal 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 delle origini dati per il tuo account, utilizza il metodo accounts.dataSources.list
.
Patch origine dati
Per aggiornare la configurazione di un'origine dati esistente, utilizza il metodo accounts.dataSources.patch
.