Premiers pas avec l'API AdMob

Ce guide est destiné aux développeurs qui souhaitent utiliser l'API AdMob pour obtenir des informations sur leur compte AdMob de manière programmatique.

Tous les appels d'API Google AdMob doivent être autorisés via OAuth2 pour 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 en savoir plus sur les autorisations, consultez la section Autorisation.

Procédez comme suit pour générer les identifiants OAuth2 et envoyer votre première requête.

Conditions préalables

Déterminer votre type d'authentification

Consultez le tableau ci-dessous pour connaître le type d'authentification le plus approprié pour votre application:

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

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, qui 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éjà d'un projet et qui préfèrent activer manuellement l'API AdMob pour celui-ci.

Pour activer une API pour votre projet:

  1. Open the API Library dans le Google API Console .
  2. If prompted, select a project, or create a new one. Le API Library répertorie toutes les API disponibles, regroupées par famille de produits et par popularité.
  3. Si l'API que vous souhaitez activer n'est pas visible 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. If prompted, enable billing.
  6. If prompted, read and accept the API's Terms of Service.

Créer des identifiants OAuth2

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

  1. Go to the Credentials page.
  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 êtes invité à le faire maintenant. Cliquez sur CONFIGURE CONSENT SCREEN (Configurer l'écran d'autorisation). 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 Tests, puis ajouter des utilisateurs de test en sélectionnant Ajouter des utilisateurs pour leur donner accès à votre ID client OAuth 2.0.

      En savoir plus sur la configuration de votre écran de consentement OAuth

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

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

Envoyer une requête

L'API AdMob est basée sur HTTP et JSON, de sorte que n'importe quel 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 analyser les réponses manuellement.

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

Définition du 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 Consulter les rapports sur les performances des annonces et sur les revenus Consultez la référence éditeur, le fuseau horaire et le code de devise par défaut.

Effectuez votre première requête pour générer un rapport à l'aide d'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 du compte Google et révoquez l'accès du projet concerné.

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