Iniziare a utilizzare l'API Ads Data Hub

Questa guida spiega come iniziare a scrivere applicazioni che utilizzano l'API Ads Data Hub REST per interagire con Ads Data Hub. L'API REST di Ads Data Hub ti consente di visualizzare i clienti di Ads Data Hub associati al tuo Account Google, creare ed eseguire query.

Configurazione

Prima di utilizzare l'API Ads Data Hub, devi completare alcuni passaggi:

1. Assicurati che all'utente che abilita l'API venga concessa l'autorizzazione serviceusage.services.enable nel progetto Google Cloud. L'utente con l'autorizzazione serviceusage.services.enable deve essere autorizzato anche ad accedere all'API.
2. Attiva l'API Ads Data Hub nel progetto Google Cloud in cui sono state create le credenziali client o l'account di servizio. Per attivare l'API Ads Data Hub per un progetto tramite la console:
   1. Vai alla libreria API di Cloud Console.
   2. Seleziona il progetto da utilizzare dall'elenco dei progetti.
   3. Cerca "API Ads Data Hub".
   4. Nella pagina dell'API, fai clic su ABILITA.
3. Gestisci autorizzazioni:
   1. L'indirizzo email o l'account di servizio utilizzato per creare le credenziali deve essere aggiunto ad Ads Data Hub con le autorizzazioni appropriate. Per un account di servizio è l'indirizzo email dell'account di servizio. Per OAuth, si tratta dell'indirizzo email dell'utente. Ciò garantisce che l'account di servizio o l'account dell'utente finale sia autorizzato a eseguire query in Ads Data Hub.
4. (Consigliato) Installa una libreria client dell'API di Google:
   1. Le librerie client delle API di Google sono disponibili in molti linguaggi diffusi e consentono di lavorare con molte API di Google. Anche se non è obbligatorio, le librerie client riducono la quantità di codice che devi scrivere e semplificano l'autenticazione.

Libreria client	Esempi di Ads Data Hub
Libreria client delle API di Google per Java	Java
Libreria client API di Google per Python

Autenticare e autorizzare

L'API Ads Data Hub può accedere ai dati nel tuo account cliente Ads Data Hub e modificarli, pertanto deve verificare che tu sia un utente autorizzato. Per questo motivo, prima di iniziare a interagire con l'API Ads Data Hub, devi attraversare una procedura di autorizzazione. Un flusso di autorizzazione ti fornisce le autorizzazioni necessarie per interagire con l'API. Puoi eseguire l'autenticazione utilizzando OAuth 2.0 o un account di servizio.

OAuth 2.0 Account di servizio

Configurazione dell'account di servizio

1. Vai alla console dell'API di Google e al tuo progetto amministratore.
2. Verifica che l'API Ads Data Hub sia attivata per il tuo progetto in API e servizi.
   1. In caso contrario, fai clic su + Abilita API e servizi e abilita l'API Ads Data Hub.
3. Nel menu di navigazione della console, fai clic su IAM e amministrazione > Account di servizio.
   1. Se non hai ancora creato un account di servizio, creane uno.
4. Fai clic sul menu con tre puntini () nella sezione "Azioni", quindi fai clic su Gestisci chiavi.
   1. Fai clic su Aggiungi chiave > Crea nuova chiave.
   2. Dopo aver selezionato "JSON", fai clic su Crea.
5. Aggiungi l'indirizzo email dell'account di servizio come utente nel tuo account Ads Data Hub.

Inviare una richiesta di esempio

#!/usr/bin/env python3

"""This sample shows how to retrieve all accounts associated with the user.
"""
import json
from google.oauth2.service_account import Credentials
from googleapiclient.discovery import build

SCOPES = ['https://www.googleapis.com/auth/adsdatahub']
DISCOVERY_URL = 'https://adsdatahub.googleapis.com/$discovery/rest?version=v1'
creds = Credentials.from_service_account_file(
    'service-account.json').with_scopes(SCOPES)
developer_key = 'YOUR_DEVELOPER_KEY'  # Replace with your developer key.
service = build('AdsDataHub', 'v1', credentials=creds,
                developerKey=developer_key, discoveryServiceUrl=DISCOVERY_URL)

# Replace with your customer ID.
customer_name = input('Customer name (e.g. "customers/123"): ').strip()
queries = service.customers().analysisQueries().list(
    parent=customer_name).execute()
print(json.dumps(queries, sort_keys=True, indent=4))

Passaggi successivi

• Visualizza query di esempio in Ads Data Hub per alcuni esempi di query che puoi creare ed eseguire con l'API REST di Ads Data Hub.
• Espandi gli esempi per acquisire familiarità con l'API e personalizzarla in base al caso d'uso. Poi, prova a:
  • Estrarre lo stato di attività della query.
  • Utilizzare una libreria client di BigQuery per recuperare i risultati delle query completati.
• Contattare l'assistenza ADH in caso di domande o feedback sull'API.