Avant de commencer à coder votre première application cliente, vous devez suivre quelques étapes (si ce n'est déjà fait).
Obtenir un compte Google
Vous devez disposer d'un compte Google pour créer un projet dans la console Google APIs. Si vous avez déjà un compte, vous êtes prêt.
Vous pouvez également créer un compte Google distinct à des fins de test.
Essayer Google AdMob
Cette documentation sur l'API part du principe que vous avez déjà utilisé Google AdMob, et que vous connaissez les concepts de programmation Web et les formats de données Web.
Si vous n'avez jamais utilisé Google AdMob, essayez l'interface utilisateur avant de commencer à coder.
Créer un projet pour votre client
Avant de pouvoir envoyer des demandes à Google AdMob, vous devez informer Google de votre client et activer l'accès à l'API. Pour ce faire, utilisez la console Google APIs pour créer un projet, c'est-à-dire une collection nommée de paramètres et d'informations d'accès à l'API, puis enregistrez votre application.
Pour commencer à utiliser l'API AdMob, vous devez d'abord utiliser l'outil de configuration, qui vous guide tout au long de la création d'un projet dans console Google APIs, activer l'API et créer des identifiants.
Apprendre les bases de l'architecture REST
REST est un style d'architecture logicielle qui permet de demander et modifier des données de manière pratique et cohérente.
Le terme REST est l'acronyme de REpresentational State Transfer. Dans le contexte des API Google, il désigne l'architecture utilisant des verbes HTTP pour récupérer et modifier les représentations des données stockées par Google.
Dans un système RESTful, les ressources sont stockées dans un datastore. Un client envoie une requête pour que le serveur exécute une action spécifique (par exemple la création, l'extraction, la mise à jour ou la suppression d'une ressource), et le serveur exécute l'action et envoie une réponse, souvent sous la forme d'une représentation de la ressource spécifiée.
Dans les API RESTful de Google, le client spécifie une action à l'aide d'un verbe HTTP comme POST, GET, PUT ou DELETE. La ressource est désignée par un URI unique au format suivant :
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Étant donné que toutes les ressources d'API possèdent des URI uniques accessibles via HTTP, REST permet la mise en cache des données, et son fonctionnement est optimisé pour l'infrastructure distribuée du Web.
Les définitions de méthode figurant dans la documentation du standard HTTP 1.1 peuvent s'avérer utiles, car elles incluent les spécifications pour GET, POST, PUT, et DELETE.
REST dans l'API AdMob
Les opérations de l'API AdMob sont directement mappées aux verbes HTTP REST.
Voici les formats spécifiques pour les URI de l'API AdMob:
https://admob.googleapis.com/v1/resourcePath?parameters
L'ensemble complet des URI utilisés pour chaque opération acceptée dans l'API figure dans la documentation de référence de l'API AdMob.
Apprendre les bases du format JSON
L'API AdMob renvoie les données au format JSON.
JSON (JavaScript Object Notation) est un format de données qui ne dépend pas d'un langage et qui fournit une représentation textuelle simple de structures de données arbitraires. Pour en savoir plus, accédez à json.org.