Panoramica dell'API Merchant Data Source

Questa pagina mostra come creare e aggiornare in modo programmatico le origini dati che ti consentono di inserire i prodotti. Le origini dati automatiche semplificano l'invio dei 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 Sources, puoi creare i seguenti tipi di origini dati:

L'API Content for Shopping ti consente di gestire solo 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 contentLanguage specifici.
  • Crea un'origine dati che non contiene feedLabel e contentLanguage campi impostati. Con questo tipo di origine dati puoi scegliere come target più paesi perché puoi inserire prodotti con diverse combinazioni di feedLabel e contentLanguage in un'unica 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.
  • Utilizza altri tipi di origini dati, come le promozioni.

Non puoi utilizzare l'API Merchant per inserire prodotti in un'origine dati che contiene prodotti locali e online. Per saperne di più sui canali delle origini dati, consulta Canali.

Prerequisiti

  • Devi aver eseguito la migrazione del tuo account a singoli feed con impostazioni internazionali.

  • Per verificare che la migrazione dell'account alla suddivisione dei target di dati sia già stata eseguita, 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

Le origini dati principali sono le origini dati principali per il tuo inventario Merchant Center. Puoi aggiungere o rimuovere prodotti solo utilizzando un'origine dati principale. Se ogni prodotto aggiunto all'origine dati principale soddisfa i dati e i requisiti di idoneità di Merchant Center, non dovrai creare altre origini 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. Per ulteriori informazioni su questi campi, consulta PrimaryProductDataSource.

Per saperne di più sulla creazione di un'origine dati, consulta accounts.dataSources.create .

Per visualizzare l'origine dati appena creata, utilizza la classe accounts.dataSources.get o accounts.dataSources.list .

Creare una nuova origine dati principale che ti aiuti a scegliere come target più paesi

Per creare un nuovo feed principale che ti aiuti a scegliere come target più paesi, configura la tua origine dati utilizzando PrimaryProductDataSource e non impostare i campi feedLabel e contentLanguage.

Se utilizzi l'API Content for Shopping, viene creata per te una sola origine dati dell'API. Se utilizzi l'API Merchant Data Origini dati del commerciante, puoi avere più origini dati dell'API, alcune delle quali possono non essere state impostate i campi feedLabel e contentLanguage.

Solo le origini dati con input API possono non avere i campi feedLabel e contentLanguage impostati. Questo tipo di origini dati non è supportato per i file di input.

Crea un'origine dati supplementare e collegala all'origine dati principale

Le origini dati supplementari vengono utilizzate solo per aggiornare i dati di prodotto già esistenti in uno o più origini dati principali. Puoi avere più origini dati e ognuna può integrare i dati in qualsiasi numero di dati principali fonti.

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 le 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 devono avere i valori feedLabel e contentLanguage campi impostati. Le origini dati dell'API supplementari devono sempre avere i campi feedLabel e contentLanguage non impostati.

Configurare una pianificazione per l'origine dati 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 l'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 l'origine dati

Per recuperare la configurazione dell'origine dati per il tuo account, utilizza il metodo accounts.dataSources.get .

Elenco origini dati

Per elencare le configurazioni delle origini dati per il tuo account, utilizza il metodo accounts.dataSources.list.

Origine dati della patch

Per aggiornare la configurazione di un'origine dati esistente, utilizza il metodo accounts.dataSources.patch.

Le origini dei dati di prodotto principali ti consentono di gestire le origini predefinite regola delle origini dati. La regola predefinita è quella che si applica a tutti gli attributi dell'origine dati. La regola predefinita può essere impostata durante la creazione dell'origine dati o aggiornando un'origine dati esistente tramite il campo della regola predefinita.

La seguente configurazione di esempio garantisce che tutti gli attributi vengano prima ricavati 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 svolgere i seguenti passaggi:

Una volta che il tuo account è idoneo alla registrazione, puoi utilizzare il metodo accounts.autofeedSettings.updateAutofeedSettings per attivare la gestione automatica delle origini dati. Attivazione della modalità automatica delle origini dati consente a Google di aggiungere automaticamente i tuoi prodotti negozio online e garantire che siano sempre aggiornati sulle piattaforme di Google.

Recuperare lo stato di caricamento file

Per conoscere lo stato di un'origine dati tra file, recupero o foglio di lavoro, devi può chiamare il metodo GET del accounts.dataSources.fileUploads completamente gestito di Google Cloud. Per ottenere il risultato dell'ultimo recupero dell'origine dati calcolata, in modo asincrono al termine dell'elaborazione dell'origine dati, utilizza il nome identificatore latest.

GET https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/datasources/{datasourceId}/fileUploads/latest

Lo stato del caricamento del file potrebbe contenere una visualizzazione dettagliata dei tuoi prodotti, inclusi eventuali 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.