Authentifier les appels d'API

Dans cet exemple, nous vous expliquons comment utiliser des comptes de service pour appeler l'API AdSense Platforms afin de créer et de gérer des sous-comptes.

Étape 1: Créez un projet Google Cloud (ou utilisez-en un existant)

Si vous disposez déjà d'un projet Google Cloud, n'hésitez pas à l'utiliser. Sinon, suivez le guide ci-dessous pour configurer un nouveau projet:

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

Étape 2: Créez un compte de service

L'utilisation de comptes de service est le meilleur moyen de créer des sous-comptes. Pour créer votre compte de service, procédez comme suit:

  • Accédez à la page Comptes de service dans Google Cloud.
  • Vous pouvez utiliser un compte de service existant ou en créer un :
    • Cliquez sur "+ Créer un compte de service".
    • Renseignez le formulaire "Détails du compte de service".
    • Les étapes 2 et 3 de la page (accorder l'accès aux projets et aux utilisateurs) sont facultatives.

Découvrez comment créer et gérer des comptes de service.

Une fois le compte de service créé, vous devez l'envoyer à Google pour qu'il soit ajouté à votre compte AdSense. Cette étape est essentielle, car l'accès au compte AdSense doit être accordé au compte de service. Veuillez nous en informer via votre responsable de compte.

Étape 3: Activer l'API AdSense Platform pour votre projet Google Cloud

L'API AdSense Platform n'est pas visible. Vous devez donc accéder au lien suivant pour l'activer pour votre projet:

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

Étape 4: Créez une clé de service

Pour générer des jetons d'accès à utiliser dans les appels d'API, vous devez créer une clé de service. Procédez comme suit :

  • Accédez à la page Comptes de service dans Google Cloud.
  • Dans la colonne "Actions", cliquez sur  pour le compte de service que vous souhaitez utiliser pour créer des sous-comptes, puis sur "Gérer les clés".
  • Cliquez sur "Ajouter une clé", puis sélectionnez "Créer une clé".
  • Laissez le type de clé JSON sélectionné, puis cliquez sur "Créer".
  • Un fichier JSON est créé et téléchargé sur votre ordinateur. Conservez-la précieusement, car vous en aurez besoin pour authentifier les appels d'API.

Découvrez comment créer et gérer des clés de compte de service.

Étape 5: Utilisez les bibliothèques OAuth de Google pour générer un jeton d'accès

Google fournit des bibliothèques pour générer des jetons d'accès, qui peuvent être utilisés pour effectuer des appels d'API. Découvrez comment générer des identifiants pour les comptes de service:

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

Le champ d'application de l'API AdSense Platforms est le suivant : https://www.googleapis.com/auth/adsense

Exemple 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

À ce stade, vous êtes prêt à commencer à appeler les API. Les bibliothèques clientes ne sont pas encore compatibles avec l'API AdSense Platform. Vous devez donc effectuer des requêtes HTTP directes. Le jeton d'accès doit être inclus en tant qu'en-tête dans la requête HTTP. L'en-tête doit se présenter comme suit:

Authorization: OAuth <credentials>

Des exemples sont fournis sur les pages des API.