Premiers pas avec l'API AdMob

Important : Les nouveaux rôles et autorisations utilisateur auront une incidence sur les données renvoyées par l'API AdMob. En savoir plus

Ce guide s'adresse aux développeurs qui souhaitent utiliser l'API AdMob pour obtenir les données de leur compte AdMob de manière programmatique.

Tous les appels à l'API Google AdMob doivent être autorisés via OAuth2 afin que votre application puisse interagir avec les services Web pour le compte de l'utilisateur. OAuth2 permet à votre application cliente de l'API AdMob d'accéder au compte AdMob d'un utilisateur sans avoir à gérer ni stocker son nom d'utilisateur ou son mot de passe. Pour obtenir une présentation de l'autorisation, consultez Autorisation.

Suivez les étapes ci-dessous pour générer les identifiants OAuth2 et effectuer votre première requête.

Prérequis

• Un compte Google

• Un compte Google AdMob

• Vous maîtrisez les principes de base de REST et l'autorisation des requêtes avec OAuth 2.0.

Déterminer votre type d'authentification

Consultez le tableau ci-dessous pour déterminer le type d'authentification le plus adapté à votre application :

Choisir votre type d'authentification OAuth2	si...
Application pour ordinateur	Vous gérez tous vos comptes d'API AdMob à l'aide d'un seul compte administrateur de niveau supérieur. Vous êtes un nouvel utilisateur ou vous souhaitez commencer rapidement avec la configuration la plus simple. Votre application n'authentifie les utilisateurs Google AdMob que depuis une seule machine.
Application Web	Vous souhaitez vous authentifier en tant qu'utilisateur pouvant accorder à votre application l'autorisation d'accéder aux données de son compte API AdMob. Vous souhaitez générer facilement plusieurs identifiants d'autorisation, par exemple pour gérer des comptes tiers. Votre application nécessite des URL de rappel, qui ne sont pas compatibles avec le flux de l'application de bureau.

Important : Vous pouvez toujours choisir le flux de l'application de bureau, même si vous développez une application à exécuter sur un serveur. La différence réside dans le fait que l'autorisation OAuth est effectuée localement ou à distance. Un flux de bureau nécessite une autorisation à effectuer sur la machine locale, tandis que le flux Web permet d'effectuer l'autorisation sur le serveur d'autorisation de Google.

Créer un projet

Pour commencer à utiliser l'API AdMob, vous devez d'abord créer ou sélectionner un projet dans la console Google APIs, puis activer l'API à l'aide de l'outil de configuration. Celui-ci vous guide tout au long du processus et active automatiquement l'API AdMob.

Activer l'API pour un projet existant

Les étapes suivantes s'appliquent aux utilisateurs qui disposent d'un projet existant et qui préfèrent activer manuellement l'API AdMob pour ce projet.

Pour activer une API pour votre projet :

1. Dans la console Google APIs, ouvrez la bibliothèque d'API.
2. Si vous y êtes invité, sélectionnez un projet ou créez-en un. La bibliothèque d'API répertorie toutes les API disponibles, regroupées par famille de produits et par popularité.
3. Si l'API que vous souhaitez activer n'apparaît pas dans la liste, utilisez la recherche pour la trouver ou cliquez sur Afficher tout dans la famille de produits à laquelle elle appartient.
4. Sélectionnez l'API que vous souhaitez activer, puis cliquez sur le bouton Activer.
5. Si vous y êtes invité, activez la facturation.
6. Si vous y êtes invité, lisez et acceptez les conditions d'utilisation de l'API.

Créer des identifiants OAuth2

Les instructions suivantes vous guident dans la création d'un ID client OAuth 2.0 à utiliser avec le flux d'application installée.

1. Accédez à la page Clients.

2. Cliquez sur CRÉER DES IDENTIFIANTS > ID client OAuth.

   Si vous n'avez pas encore configuré d'écran de consentement OAuth pour ce projet, vous serez invité à le faire maintenant. Cliquez sur CONFIGURER L'ÉCRAN DE CONSENTEMENT. Il existe plusieurs façons de configurer votre écran de consentement pour utiliser votre ID client OAuth 2.0.

   1. Définissez le type d'utilisateur sur Externe et l'état de publication sur Publié.

   2. Vous pouvez également définir votre type d'utilisateur sur Externe et l'état de publication sur Test, puis ajouter des utilisateurs tests en sélectionnant Ajouter des utilisateurs pour leur donner accès à votre ID client OAuth 2.0.

      Pour en savoir plus, consultez Configurer votre écran de consentement OAuth.

3. Sélectionnez Application de bureau ou Application Web comme type d'application, donnez-lui un nom, puis cliquez sur Créer.

Une fois l'opération terminée, un ID client et un code secret client OAuth 2.0 s'affichent. Vous pouvez les télécharger au format JSON et les enregistrer pour les utiliser ultérieurement.

Envoyer une requête

L'API AdMob étant basée sur HTTP et JSON, tout client HTTP standard peut lui envoyer des requêtes et analyser les réponses. Toutefois, les bibliothèques clientes des API Google permettent d'intégrer plus facilement les langages de programmation, d'améliorer la sécurité et d'accepter les requêtes autorisées. Les bibliothèques clientes sont disponibles pour un grand nombre de langages de programmation. Elles vous évitent de devoir configurer les requêtes HTTP et d'analyser les réponses manuellement.

Remarque : La première fois que vous activez le flux OAuth, vous êtes invité à fournir votre référence éditeur AdMob et à accepter une invite d'autorisation dans votre navigateur. Avant d'accepter, assurez-vous d'être connecté avec un compte Google ayant accès à votre compte AdMob. Votre application est alors autorisée à accéder aux données au nom du compte actuellement connecté.

Une fois les identifiants OAuth 2.0 créés, vous pouvez commencer à utiliser l'API AdMob. Pour demander l'accès via OAuth 2.0, votre application a également besoin d'informations sur le champ d'application :

Champ d'application	Signification
https://www.googleapis.com/auth/admob.readonly	Consultez toutes les données AdMob. Il peut s'agir d'informations sur le compte, de paramètres d'inventaire et de médiation, de rapports et d'autres données. Aucune donnée sensible (paiements, détails de vos campagnes, etc.) ne sera concernée.
https://www.googleapis.com/auth/admob.report	Consultez les rapports sur les performances des annonces et les revenus. Affichez la référence éditeur, le fuseau horaire et le code de devise par défaut.

Envoyez votre première requête pour générer un rapport à l'aide des exemples en Java, PHP, Python ou curl.

Révoquer les jetons partagés

Vous pouvez révoquer les jetons partagés de deux manières :

1. Accédez à la page des autorisations de votre compte Google et révoquez l'accès au projet concerné.

2. Vous pouvez également révoquer des jetons d'application Web à l'aide de l'API Google Identity.