Autenticazione delle chiamate API

In questo esempio, viene illustrato come gli account di servizio possono essere utilizzati per chiamare l'API AdSense Platforms per creare e gestire i subaccount.

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

Se hai già un progetto Google Cloud, utilizzalo. In caso contrario, segui la guida riportata di seguito per la configurazione di 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, segui questi passaggi:

  • 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 campo "Dettagli account di servizio". modulo
    • I passaggi 2 e 3 nella 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 è essenziale, perché 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 Azioni, fai clic su per l'account di servizio che vuoi utilizzare per creare subaccount e poi su "Gestisci chiavi"
  • Fai clic su "Aggiungi chiave" e poi seleziona "Crea nuova chiave"
  • Mantieni selezionato JSON come tipo di chiave e fai clic su "Crea"
  • Sul computer verrà creato e scaricato un file JSON. Tienilo al sicuro poiché 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 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, sarà 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.