Autenticazione delle chiamate API

In questo esempio, mostriamo come gli account di servizio possono essere utilizzati per chiamare l'API Piattaforme AdSense e creare e gestire subaccount.

Passaggio 1: crea un nuovo progetto Google Cloud (o utilizzane uno esistente)

Se hai già un progetto Google Cloud, puoi usarlo. In caso contrario, segui la guida qui sotto per configurare un nuovo progetto:

https://cloud.google.com/resource-manager/docs/creating-managing-projects

Passaggio 2: crea un account di servizio

L'utilizzo degli account di servizio è il modo migliore per creare subaccount. Per creare l'account di servizio:

  • Visita la pagina degli account di servizio in Google Cloud
  • Puoi utilizzare un account di servizio esistente o crearne uno nuovo:
    • Fai clic su "+ Crea account di servizio"
    • Compila il modulo "Dettagli account di servizio"
    • I passaggi 2 e 3 della pagina (concedere l'accesso a progetti e utenti) sono facoltativi

Scopri di più su come creare e gestire gli account di servizio.

Una volta creato l'account di servizio, devi inviarlo a Google per aggiungerlo al tuo account AdSense. Questo è fondamentale, poiché l'account di servizio deve essere autorizzato ad accedere al tuo account AdSense. Comunicalo tramite il tuo account manager.

Passaggio 3: attiva l'API AdSense Platform per il tuo progetto Google Cloud

L'API della piattaforma AdSense non è rilevabile, il che significa che devi visitare il seguente link per abilitarla per il tuo progetto:

https://console.developers.google.com/apis/api/adsenseplatform.googleapis.com/overview

Passaggio 4: crea una chiave di servizio

Per generare token di accesso da utilizzare nelle chiamate API, devi creare una chiave di servizio. Segui questi passaggi:

  • Visita la pagina degli account di servizio in Google Cloud
  • Nella colonna delle azioni, per l'account di servizio che vuoi utilizzare per creare subaccount, fai clic su e poi su "Gestisci chiavi"
  • Fai clic su "Aggiungi chiave", quindi seleziona "Crea nuova chiave"
  • Mantieni JSON selezionato come tipo di chiave e fai clic su "Crea"
  • Verrà creato e scaricato un file JSON sul computer. Tienilo al sicuro perché sarà necessario per autenticare le chiamate API

Scopri di più su come creare e gestire le chiavi degli account di servizio.

Passaggio 5: utilizza le librerie OAuth di Google per generare un token di accesso

Google fornisce librerie per contribuire a generare token di accesso che possono essere utilizzati per effettuare le chiamate API. Scopri come generare le credenziali per gli account di servizio qui:

https://developers.google.com/identity/protocols/oauth2/service-account#authorizingrequests

L'ambito dell'API AdSense Platforms è il seguente: https://www.googleapis.com/auth/adsense

Esempio Python

from google.auth.transport import requests
from google.oauth2 import service_account

CREDENTIAL_SCOPES = ["https://www.googleapis.com/auth/adsense"]
CREDENTIALS_KEY_PATH = 'service.json'

def get_service_account_token():
  credentials = service_account.Credentials.from_service_account_file(
          CREDENTIALS_KEY_PATH, scopes=CREDENTIAL_SCOPES)
  credentials.refresh(requests.Request())
  return credentials.token

In questa fase, puoi iniziare a chiamare le API. Poiché le librerie client non sono ancora supportate per l'API AdSense Platform, è necessario effettuare richieste HTTP dirette. Il token di accesso deve essere incluso come intestazione nella richiesta HTTP. L'intestazione dovrebbe avere il seguente aspetto:

Authorization: OAuth <credentials>

Gli esempi sono inclusi nelle pagine dell'API.