Pianificare i trasferimenti da Google Merchant Center

Prima di iniziare

Prima di creare un trasferimento di dati Google Merchant Center:

  • Verifica di aver completato tutte le azioni necessarie per abilitare BigQuery Data Transfer Service.
  • Crea un set di dati BigQuery per archiviare i dati di Google Merchant Center.
    • Per la regione del set di dati, supportiamo l'utilizzo dell'opzione predefinita Multiregionale, in negli Stati Uniti o nell'Unione Europea.
    • Se vuoi creare un set di dati in una regione specifica, Il trasferimento di dati è supportato solo nelle seguenti regioni:
    • us-east4 (Northern Virginia),
    • asia-northeast1 (Tokyo),
    • asia-southeast1 (Singapore),
    • australia-southeast1 (Sydney),
    • europe-north1 (Finland),
    • europe-west2 (London),
    • europe-west6 (Zurich).
  • Se intendi configurare le notifiche di esecuzione del trasferimento per Pub/Sub, deve avere le autorizzazioni pubsub.topics.setIamPolicy. Pub/Sub le autorizzazioni non sono necessarie se hai appena configurato le notifiche via email. Per maggiori informazioni le informazioni, vedi Notifiche di esecuzione di BigQuery Data Transfer Service.

Autorizzazioni obbligatorie

Assicurati che la persona che crea il trasferimento dei dati disponga delle seguenti autorizzazioni obbligatorie:

  • BigQuery:

    • Autorizzazioni bigquery.transfers.update per creare il trasferimento di dati
    • Autorizzazioni bigquery.datasets.get e bigquery.datasets.update attive il set di dati di destinazione

    Il ruolo IAM predefinito bigquery.admin include le autorizzazioni bigquery.transfers.update, bigquery.datasets.update e bigquery.datasets.get. Per ulteriori informazioni sui ruoli IAM in BigQuery Data Transfer Service, consulta Controllo dell'accesso.

  • Google Merchant Center

Configurare un trasferimento da Google Merchant Center

La configurazione di un trasferimento di dati per i report di Google Merchant Center richiede seguenti:

Per creare un trasferimento di dati per i report di Google Merchant Center:

Console

  1. Vai alla pagina Trasferimenti dati nella console Google Cloud.

    Vai a Trasferimenti dati

  2. Fai clic su Crea trasferimento.

  3. Nella pagina Crea trasferimento:

    • Nella sezione Tipo di origine, per Origine, scegli Google Merchant Center.

    • Nella sezione Nome configurazione di trasferimento, in Nome visualizzato, inserisci un nome per il trasferimento dei dati, ad esempio My Transfer. Il nome del trasferimento può essere qualsiasi valore che ti consenta di identificare il trasferimento se devi modificare in un secondo momento.

      Nome trasferimento

    • Nella sezione Opzioni di programmazione:

      • Seleziona una Frequenza di ripetizione. Se selezioni Ore, Giorni, Settimane o Mesi, devi anche specificare una frequenza. Puoi anche selezionare Personalizzata per specificare una frequenza di ripetizione personalizzata. Se selezioni On demand, questo trasferimento di dati viene eseguito attivi manualmente il trasferimento.

      • Se applicabile, seleziona Inizia ora o Inizia all'ora impostata e fornisci una data di inizio e un'ora di esecuzione.

      • In Data di inizio e ora di esecuzione, inserisci la data e l'ora di inizio del trasferimento. Questo valore deve essere successivo di almeno 24 ore rispetto a l'ora UTC attuale. Se scegli Inizia ora, l'opzione è disattivata.

        Programmazione dei trasferimenti

        Se lasci le opzioni di pianificazione impostate su Avvia ora, la prima esecuzione del trasferimento dei dati inizierà immediatamente e non andrà a buon fine con il seguente messaggio di errore: No data to transfer found for the Merchant account. If you have just created this transfer, you may need to wait for up to a day before the data of your Merchant account are prepared and available for the transfer. La successiva esecuzione pianificata dovrebbe essere eseguita correttamente. Se i dati del tuo account commerciante sono preparati nella stessa data nel fuso orario UTC, puoi configurare un backfill per l'esecuzione di oggi.

    • Nella sezione Impostazioni destinazione, per Set di dati di destinazione, scegli il set di dati che hai creato per archiviare i tuoi dati.

      Trasferisci set di dati

    • Nella sezione Dettagli dell'origine dati, in ID commerciante, inserisci il tuo ID commerciante o ID AMC.

      Seleziona i report che vuoi trasferire. Vedi i contenuti supportati Report per ulteriori dettagli.

      Dati di trasferimento da Google Merchant Center.

    • Nel menu Account di servizio, seleziona un account di servizio tra quelli associati al tuo progetto Google Cloud. Puoi associare un account di servizio a il trasferimento dei dati anziché utilizzare le tue credenziali utente. Per ulteriori informazioni sull'utilizzo degli account di servizio con i trasferimenti di dati, consulta Utilizzare gli account di servizio.

      • Se hai eseguito l'accesso con un'identità federata, è necessario un account di servizio per creare un trasferimento di dati. Se hai firmato con un Account Google, poi l'account di servizio per il trasferimento è facoltativo.
      • L'account di servizio deve disporre delle autorizzazioni richieste.
    • (Facoltativo) Nella sezione Opzioni di notifica:

      • Fai clic sul pulsante di attivazione/disattivazione per attivare le notifiche via email. Se attivi questa opzione, l'amministratore dei trasferimenti riceve una notifica via email quando un'esecuzione del trasferimento non va a buon fine.
      • Per Seleziona un argomento Pub/Sub, scegli l'argomento o fai clic su Crea un argomento. Questa opzione configura le notifiche di esecuzione di Pub/Sub per il trasferimento.
  4. Fai clic su Salva.

bq

Inserisci il comando bq mk e specifica il flag di creazione del trasferimento: --transfer_config. Sono necessari anche i seguenti flag:

  • --data_source
  • --target_dataset
  • --display_name
  • --params

Puoi anche fornire il flag --project_id per specificare una determinata progetto. Se --project_id non è specificato, viene utilizzato il progetto predefinito.

bq mk \
--transfer_config \
--project_id=project_id \
--target_dataset=dataset \
--display_name=name \
--params='parameters' \
--data_source=data_source
--service_account_name=service_account_name

Dove:

  • project_id è l'ID progetto.
  • dataset è il set di dati di destinazione per la configurazione del trasferimento.
  • name è il nome visualizzato della configurazione di trasferimento. Il nome del trasferimento può essere qualsiasi valore che ti consenta di identificare il trasferimento se devi modificarlo in un secondo momento.
  • parameters contiene i parametri per il trasferimento creato configurazione in formato JSON. Ad esempio: --params='{"param":"param_value"}'.
    • Per i trasferimenti di dati di Google Merchant Center, devi fornire il merchant_id .
    • Il parametro export_products specifica se trasferire i dati di prodotto e dei problemi relativi ai prodotti. Questo parametro è incluso per impostazione predefinita, anche se non specifichi il parametro export_products. Google consiglia includere questo parametro in modo esplicito e impostarlo su "true".
    • Il parametro export_regional_inventories consente di specificare se trasferire i dati degli inventari regionali.
    • Il parametro export_local_inventories specifica se trasferire i dati degli inventari locali.
    • Il parametro export_price_competitiveness specifica se trasferire i dati sulla competitività del prezzo.
    • Il parametro export_price_insights consente di specificare se trasferire o meno Approfondimenti sul prezzo.
    • Il parametro export_best_sellers_v2 specifica se trasferire o meno i dati dei best seller.
    • Il parametro export_performance specifica se trasferire i dati sul rendimento del prodotto.
  • data_source è l'origine dati - merchant_center.
  • service_account_name è il nome dell'account di servizio utilizzato per autenticare il trasferimento dei dati. L'account di servizio deve essere di proprietà dello stesso project_id utilizzato per creare il trasferimento e deve disporre di tutte le autorizzazioni richieste.

Ad esempio, il seguente comando crea un trasferimento di dati di Google Merchant Center chiamato My Transfer utilizzando l'ID commerciante 1234 e il set di dati di destinazione mydataset. Il trasferimento dei dati viene creato nel progetto predefinito.

bq mk \
--transfer_config \
--target_dataset=mydataset \
--display_name='My Transfer' \
--params='{"merchant_id":"1234","export_products":"true","export_regional_inventories":"true","export_local_inventories":"true","export_price_benchmarks":"true","export_best_sellers":"true"}' \
--data_source=merchant_center

La prima volta che esegui il comando, ricevi un messaggio simile al seguente:

[URL omitted] Please copy and paste the above URL into your web browser and follow the instructions to retrieve an authentication code.

Segui le istruzioni nel messaggio e incolla il codice di autenticazione la riga di comando.

.

Se hai appena creato questo trasferimento di dati, potrebbe essere necessario attendere fino a un giorno prima che i dati del tuo account commerciante siano preparati e disponibili per trasferimento.` La prossima esecuzione pianificata dovrebbe essere eseguita correttamente. Se i dati del tuo account Merchant vengono preparati nella stessa data in ora UTC, puoi configurare un backfill per l'esecuzione di oggi.

API

Utilizza la projects.locations.transferConfigs.create e fornisce un'istanza del metodo TransferConfig risorsa.

Risolvere i problemi di configurazione del trasferimento da Google Merchant Center

Se riscontri problemi durante la configurazione del trasferimento di dati, vedi Problemi di trasferimento da Google Merchant Center in Risoluzione dei problemi di configurazione del trasferimento di BigQuery Data Transfer Service.