Authentifier les appels d'API

Cet exemple montre comment utiliser les comptes de service pour appeler l'API des plates-formes AdSense 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: <ph type="x-smartling-placeholder">
  </ph>
  • Cliquez sur "+ Créer un compte de service".
  • Remplissez "Détails du compte de service" formulaire
  • Les étapes 2 et 3 présentées sur cette page (octroi de 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 le communiquer via votre responsable de compte.

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

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

Découvrez comment créer et gérer les 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:

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, vous devez effectuer des demandes HTTP directes à 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 devrait se présenter comme suit:

Authorization: OAuth <credentials>

Des exemples sont inclus dans les pages de l'API.