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.