Eseguire la migrazione delle origini dati

Questa guida spiega come eseguire la migrazione dell'integrazione dai servizi datafeeds e datafeedstatuses dell'API Content for Shopping alla sub-API Origini dati nell'API Merchant. La nuova API secondaria Origini dati offre un controllo più diretto sulle pipeline di dati e semplifica la gestione delle origini dati.

Per ulteriori informazioni sulle nuove funzionalità, consulta la guida Gestire le origini dati.

Differenze principali

Rispetto all'API Content for Shopping, l'API Merchant offre diversi vantaggi.

• Creazione esplicita dell'origine dati. L'API non crea più automaticamente un'origine dati "API Content" al primo inserimento del prodotto. Nell'API Merchant, crei esplicitamente le origini dati prima di poter caricare i prodotti. In questo modo, avrai un maggiore controllo sull'organizzazione e sulla gestione delle pipeline di dati di prodotto fin dall'inizio.

• Supporto per più origini dati API. Nell'API Content for Shopping, potevi utilizzare una sola origine dati "API Content" creata automaticamente. Con l'API Merchant puoi creare e gestire più origini dati di tipo di input API.

• Origini dati senza etichetta e lingua. L'API Merchant ti consente di creare un'origine dati principale senza specificare un feedLabel e un contentLanguage. Questo tipo di origine dati accetta prodotti in qualsiasi combinazione di feedLabel e contentLanguage, il che semplifica il caricamento dei prodotti per le integrazioni che non richiedono origini dati separate per regioni diverse.

• Target di dati semplificati. Ogni origine dati ora corrisponde a un singolo target, definito da una combinazione univoca di feedLabel e contentLanguage. I feed di destinazione con più dati sono ritirati nell'API Merchant.

• Stato di caricamento dei file dedicato. L'API Merchant rappresenta lo stato delle origini dati basate su file utilizzando una risorsa fileUploads separata di sola lettura. Per recuperare lo stato di caricamento di un file, utilizza il metodo fileUploads.get con l'alias latest.

• Nuovi tipi di origini dati. La risorsa DataSource supporta più verticali, tra cui promozioni, inventario locale e inventario regionale, fornendo un modo unificato per gestire tutte le pipeline di dati.

• Origini dati automatiche. Con l'API Merchant ora puoi attivare o disattivare la funzionalità Origini dati automatiche per il tuo account utilizzando il metodo autofeedSettings.updateAutofeedSettings nell'API secondaria Accounts. Per saperne di più, consulta Configurare le impostazioni di Autofeed.

Richieste

La seguente tabella confronta i formati degli URL delle richieste tra l'API Content for Shopping e l'API Merchant.

Descrizione della richiesta	API Content per Shopping	API Merchant
Creare un'origine dati	POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds	POST https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources
Recuperare un'origine dati	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds/{DATAFEED_ID}	GET https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}
Elenco origini dati	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds	GET https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources
Aggiornare un'origine dati	PUT https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds/{DATAFEED_ID}	PATCH https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}
Eliminare un'origine dati	DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds/{DATAFEED_ID}	DELETE https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}
Recuperare un'origine dati	POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds/{DATAFEED_ID}/fetchNow	POST https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}:fetch
Recupero dello stato dell'origine dati	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeedstatuses/{DATAFEED_ID}	GET https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}/fileUploads/latest
Elenca gli stati delle origini dati	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeedstatuses	Non disponibile. Utilizza dataSources.list e fileUploads.get per ogni origine dati basata su file.

Identificatori

L'API Merchant utilizza un nome risorsa basato su stringhe come identificatore.

Descrizione dell'identificatore	API Content per Shopping	API Merchant
Identificatore dell'origine dati	datafeedId (numerico)	name (stringa, formato: accounts/{account}/dataSources/{datasource})

Metodi

Questa tabella confronta i metodi dei servizi API Content for Shopping datafeeds e datafeedstatuses con i loro equivalenti nell'API Merchant.

Metodo API Content for Shopping	Metodo API Merchant	Disponibilità e note
datafeeds.custombatch	Non disponibile	Utilizza invece chiamate API individuali.
datafeeds.delete	dataSources.delete	Disponibile
datafeeds.fetchnow	dataSources.fetch	Disponibile Questo metodo ora funziona solo per le origini dati con un input di file.
datafeeds.get	dataSources.get	Disponibile
datafeeds.insert	dataSources.create	Disponibile
datafeeds.list	dataSources.list	Disponibile
datafeeds.update	dataSources.update	Disponibile Utilizza la semantica PATCH anziché PUT.
datafeedstatuses.custombatch	Non disponibile	Utilizza invece chiamate API individuali. Per saperne di più, consulta la sezione Inviare più richieste contemporaneamente.
datafeedstatuses.get	fileUploads.get	Disponibile per le origini dati basate su file. Utilizza l'alias latest per ottenere lo stato dell'ultimo caricamento. Per altri tipi di origini dati, le informazioni sullo stato fanno parte della risorsa DataSource.
datafeedstatuses.list	Non disponibile	Per ottenere lo stato di più origini dati, elenca prima tutte le origini dati con dataSources.list. Poi chiama fileUploads.get con l'alias latest per ogni origine dati basata su file.

Modifiche dettagliate ai campi

Questa tabella mostra le modifiche a livello di campo tra le risorse Datafeed e DatafeedStatus nell'API Content for Shopping e le risorse DataSource e FileUpload nell'API Merchant.

API Content per Shopping	API Merchant	Descrizione
Datafeed	DataSource	La risorsa principale per la configurazione dell'origine dati.
id	name	L'identificatore della risorsa. È stato modificato da un ID numerico a un nome risorsa stringa.
name	displayName	Il nome dell'origine dati visibile all'utente.
attributeLanguage	primaryProductDataSource.contentLanguage	Il codice lingua ISO 639-1 a due lettere degli elementi nell'origine dati.
fileName	fileInput.fileName	Il nome del file caricato. Questo campo ora è nidificato in fileInput.
fetchSchedule	fileInput.fetchSettings	La pianificazione per il recupero di un'origine dati basata su file. Ora è nidificato in fileInput.
fetchSchedule.paused	fileInput.fetchSettings.enabled	La logica è invertita. paused: true è equivalente a enabled: false.
format	Non disponibile	I campi fileEncoding, columnDelimiter e quotingMode vengono rimossi. Ora vengono rilevati automaticamente.
targets	primaryProductDataSource.feedLabel, primaryProductDataSource.contentLanguage, primaryProductDataSource.countries	Il campo ripetuto targets viene rimosso. Ogni origine dati ora ha un unico target definito da questi campi, il che riflette il ritiro dei feed con più target di dati.
DatafeedStatus	FileUpload	Lo stato del caricamento di un file è ora una risorsa separata di sola lettura.
datafeedId	name	L'identificatore del caricamento del file, che fa riferimento all'origine dati principale.
processingStatus	processingState	Lo stato di elaborazione del caricamento. I valori stringa (success, failure, in progress) vengono sostituiti da un'enumerazione (SUCCEEDED, FAILED, IN_PROGRESS).
errors, warnings	issues	Errori e avvisi vengono uniti in un unico elenco issues. Ogni problema ha un campo severity (ERROR o WARNING).
lastUploadDate	uploadTime	Il timestamp dell'ultimo caricamento. Il formato è cambiato da stringa a oggetto Timestamp.
country, language, feedLabel	Non applicabile	Questi campi non sono più presenti nella risorsa di stato. Fanno parte della risorsa DataSource.
targets[].included_destinations, targets[].excluded_destinations	primaryProductDataSource.destinations	I due elenchi separati per le destinazioni incluse ed escluse vengono sostituiti da un unico elenco destinations. Ogni elemento nel nuovo elenco è un oggetto che specifica la destinazione e il relativo stato (ENABLED o DISABLED), fornendo una configurazione più esplicita.