Copiare dati da Google AdWords usando Azure Data Factory o Synapse Analytics

SI APPLICA A: Azure Data Factory Azure Synapse Analytics

Questo articolo illustra come usare l'attività di copia in una pipeline di Azure Data Factory o Synapse Analytics per copiare dati da Google AdWords. Si basa sull'articolo di panoramica dell'attività di copia che presenta una panoramica generale sull'attività di copia.

Funzionalità supportate

Questo connettore Google AdWords è supportato per le funzionalità seguenti:

Funzionalità supportate IR
attività Copy (origine/-) ① ②
Attività Lookup ① ②

(1) Runtime di integrazione di Azure (2) Runtime di integrazione self-hosted

Per un elenco degli archivi dati supportati come origini/sink, vedere la tabella Archivi dati supportati .

Il servizio fornisce un driver predefinito per abilitare la connettività, pertanto non è necessario installare manualmente alcun driver usando questo connettore.

Introduzione

Per eseguire l'attività di copia con una pipeline, è possibile usare uno degli strumenti o SDK seguenti:

Creare un servizio collegato a Google AdWords usando l'interfaccia utente

Seguire questa procedura per creare un servizio collegato a Google AdWords nell'interfaccia utente di portale di Azure.

  1. Passare alla scheda Gestisci nell'area di lavoro Azure Data Factory o Synapse e selezionare Servizi collegati, quindi fare clic su Nuovo:

  2. Cercare Google e selezionare il connettore Google AdWords.

    Screenshot del connettore Google AdWords.

  3. Configurare i dettagli del servizio, testare la connessione e creare il nuovo servizio collegato.

    Screenshot della configurazione del servizio collegato per Google AdWords.

Dettagli di configurazione del connettore

Le sezioni seguenti riportano informazioni dettagliate sulle proprietà che vengono usate per definire entità specifiche di Data Factory per il connettore Google AdWords.

Proprietà del servizio collegato

Importante

A causa del tramonto dell'API Google AdWords entro il 27 aprile 2022, il servizio è stato aggiornato alla nuova API Google Ads. Fare riferimento a questo documento per i passaggi e le raccomandazioni dettagliate sulla migrazione. Assicurarsi che la migrazione venga eseguita prima del 27 aprile 2022.

Per il servizio collegato a Google AdWords sono supportate le proprietà seguenti:

Proprietà Descrizione Obbligatoria
type La proprietà tipo deve essere impostata su GoogleAdWords
connectionProperties Gruppo di proprietà che definisce come connettersi a Google AdWords.
In connectionProperties:
clientCustomerID L'ID cliente Client dell'account AdWords di cui si desidera recuperare i dati del report.
loginCustomerID ID cliente dell'account manager di Google AdWords tramite il quale vuoi recuperare i dati del report di un cliente specifico. No
developerToken Il token degli sviluppatori associato all'account di gestione che si usa per concedere l'accesso all'API AdWords. È possibile scegliere di contrassegnare questo campo come SecureString per archiviarla in modo sicuro o archiviarla in Azure Key Vault e consentire all'attività di copia di eseguire il pull da questa posizione durante l'esecuzione della copia dei dati. Per altre informazioni, vedere Archiviare le credenziali in Key Vault.
authenticationType Meccanismo di autenticazione OAuth 2.0 usato per l'autenticazione. È possibile usare ServiceAuthentication solo su runtime di integrazione self-hosted.
I valori consentiti sono ServiceAuthentication, UserAuthentication
refreshToken Il token di aggiornamento ottenuto da Google per autorizzare l'accesso a AdWords per UserAuthentication. È possibile scegliere di contrassegnare questo campo come SecureString per archiviarla in modo sicuro o archiviarla in Azure Key Vault e consentire all'attività di copia di eseguire il pull da questa posizione durante l'esecuzione della copia dei dati. Per altre informazioni, vedere Archiviare le credenziali in Key Vault. No
clientId ID client dell'applicazione Google usata per acquisire il token di aggiornamento. È possibile scegliere di contrassegnare questo campo come SecureString per archiviarla in modo sicuro o archiviarla in Azure Key Vault e consentire all'attività di copia di eseguire il pull da questa posizione durante l'esecuzione della copia dei dati. Per altre informazioni, vedere Archiviare le credenziali in Key Vault. No
clientSecret Il segreto client dell'applicazione google usata per acquisire il token di aggiornamento. È possibile scegliere di contrassegnare questo campo come SecureString per archiviarla in modo sicuro o archiviarla in Azure Key Vault e consentire all'attività di copia di eseguire il pull da questa posizione durante l'esecuzione della copia dei dati. Per altre informazioni, vedere Archiviare le credenziali in Key Vault. No
email ID di posta elettronica dell'account del servizio usato per ServiceAuthentication. Può essere usato solo su runtime di integrazione self-hosted. No
keyFilePath Il percorso completo del .p12 file di chiave o .json usato per autenticare l'indirizzo di posta elettronica dell'account del servizio e può essere usato solo nel runtime di integrazione self-hosted. No
trustedCertPath Percorso completo del file con estensione pem contenente certificati CA attendibili per la verifica del server durante la connessione tramite TLS. Questa proprietà può essere impostata solo quando si usa TLS in runtime di integrazione self-hosted. Il valore predefinito è il file cacerts.pem installato con il runtime di integrazione. No
useSystemTrustStore Specifica se usare o meno un certificato della CA dall'archivio di scopi consentiti o da un file .pem specificato. Il valore predefinito è false. No

Esempio:

{
    "name": "GoogleAdWordsLinkedService",
    "properties": {
        "type": "GoogleAdWords",
        "typeProperties": {
            "connectionProperties": {
                "clientCustomerID": "<clientCustomerID>",
                "loginCustomerID": "<loginCustomerID>",
                "developerToken": {
                    "type": "SecureString",
                    "value": "<developerToken>"
                },
                "authenticationType": "ServiceAuthentication",
                "refreshToken": {
                    "type": "SecureString",
                    "value": "<refreshToken>"
                },
                "clientId": {
                    "type": "SecureString",
                    "value": "<clientId>"
                },
                "clientSecret": {
                    "type": "SecureString",
                    "value": "<clientSecret>"
                },
                "email": "<email>",
                "keyFilePath": "<keyFilePath>",
                "trustedCertPath": "<trustedCertPath>",
                "useSystemTrustStore": true,
            }
        }
    }
}

Proprietà del set di dati

Per un elenco completo delle sezioni e delle proprietà disponibili per la definizione di set di dati, vedere l'articolo sui set di dati. Questa sezione presenta un elenco delle proprietà supportate dal set di dati di Google AdWords.

Per copiare dati da Google AdWords, impostare la proprietà tipo del set di dati su GoogleAdWordsObject. Sono supportate le proprietà seguenti:

Proprietà Descrizione Obbligatoria
type La proprietà type del set di dati deve essere impostata su: GoogleAdWordsObject
tableName Nome della tabella. No (se nell'origine dell'attività è specificato "query")

Esempio

{
    "name": "GoogleAdWordsDataset",
    "properties": {
        "type": "GoogleAdWordsObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<GoogleAdWords linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Proprietà dell'attività di copia

Per un elenco completo delle sezioni e delle proprietà disponibili per la definizione delle attività, vedere l'articolo sulle pipeline. Questa sezione presenta un elenco delle proprietà supportate dall'origine di Google AdWords.

Google AdWords come origine

Per copiare dati da Google AdWords, impostare il tipo di origine nell'attività di copia su GoogleAdWordsSource. Nella sezione origine dell'attività di copia sono supportate le proprietà seguenti:

Proprietà Descrizione Obbligatoria
type La proprietà tipo dell'origine dell'attività di copia deve essere impostata su: GoogleADWordsSource
query Usare la query SQL personalizzata per leggere i dati. Ad esempio: "SELECT * FROM MyTable". No (se nel set di dati è specificato "tableName")

Esempio:

"activities":[
    {
        "name": "CopyFromGoogleAdWords",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<GoogleAdWords input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "GoogleAdWordsSource",
                "query": "SELECT * FROM MyTable"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Proprietà dell'attività Lookup

Per altre informazioni sulle proprietà, vedere Attività Lookup.

Passaggi successivi

Per un elenco di archivi dati supportati come origini e sink dall'attività di copia, vedere Archivi dati supportati.