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
ebigquery.datasets.update
attive il set di dati di destinazione
Il ruolo IAM predefinito
bigquery.admin
include le autorizzazionibigquery.transfers.update
,bigquery.datasets.update
ebigquery.datasets.get
. Per ulteriori informazioni sui ruoli IAM in BigQuery Data Transfer Service, consulta Controllo dell'accesso.- Autorizzazioni
Google Merchant Center
Accesso standard all'account Google Merchant Center utilizzato nel trasferimento configurazione. Puoi verificare l'accesso facendo clic sulla sezione Utenti nell'interfaccia utente di Google Merchant Center.
Per accedere ai dati sulla competitività del prezzo e sui prodotti più venduti, devi soddisfare i requisiti di idoneità per le analisi di mercato.
Configurare un trasferimento da Google Merchant Center
La configurazione di un trasferimento di dati per i report di Google Merchant Center richiede seguenti:
- ID commerciante o ID account multicliente: si tratta dell'ID commerciante mostrato nella UI di Google Merchant Center.
Per creare un trasferimento di dati per i report di Google Merchant Center:
Console
Vai alla pagina Trasferimenti dati nella console Google Cloud.
Fai clic su
Crea trasferimento.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.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.
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.
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.
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.
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 parametroexport_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.
- Per i trasferimenti di dati di Google Merchant Center, devi fornire il
- 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.