Authentification des appels d'API

Dans cet exemple, nous vous expliquons comment utiliser les 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 un projet existant)

Si vous avez déjà 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".
    • Remplir le formulaire "Détails du compte de service"
    • Les étapes 2 et 3 de la page (accordant 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 le compte de service doit être autorisé à accéder à votre compte AdSense. Veuillez l'indiquer à votre responsable de compte.

Étape 3: Activer l'API de la plate-forme AdSense pour votre projet Google Cloud

L'API de la plate-forme AdSense n'est pas visible. Vous devez donc accéder au lien suivant afin de 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", au niveau du compte de service que vous souhaitez utiliser pour créer des sous-comptes, cliquez sur , puis sur "Gérer les clés".
  • Cliquez sur "Ajouter une clé", puis sélectionnez "Créer une clé".
  • Laissez "JSON" sélectionné comme type de clé, puis cliquez sur "Créer".
  • Un fichier json sera créé et téléchargé sur votre ordinateur. Conservez-le en lieu sûr, car il sera nécessaire pour authentifier les appels d'API.

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

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

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

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 pouvez commencer à appeler les API. Étant donné que les bibliothèques clientes ne sont pas encore compatibles avec l'API de la plate-forme AdSense, des requêtes HTTP directes doivent être effectuées à la place. 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>

Vous trouverez des exemples dans les pages de l'API.