Bevor Sie mit der Codierung Ihrer ersten Client-Anwendung beginnen, müssen Sie einige Vorbereitungen treffen (falls noch nicht geschehen).
Einrichten eines Google-Kontos
Sie benötigen ein Google-Konto, um in der Google API Console ein Projekt zu erstellen. Wenn Sie bereits ein solches Konto haben, sind Sie schon startklar.
Für Testzwecke könnte ein separates Google-Konto sinnvoll sein.
Google AdMob ausprobieren
In dieser API-Dokumentation wird davon ausgegangen, dass Sie Google AdMob bereits verwendet haben und sich mit Webprogrammierung und Webdatenformaten auskennen.
Wenn Sie Google AdMob noch nicht verwendet haben, machen Sie sich mit der Benutzeroberfläche vertraut, bevor Sie mit dem Programmieren beginnen.
Projekt für den Client erstellen
Bevor Sie Anfragen an Google AdMob senden können, müssen Sie Google über Ihren Client informieren und den Zugriff auf die API aktivieren. Verwende dazu die Google API Console, um ein Projekt zu erstellen und um deine Anwendung zu registrieren. Bei einem Projekt handelt es sich um eine mit einem Namen versehene Sammlung von Einstellungen und Informationen zum API-Zugriff.
Damit Sie die AdMob API verwenden können, müssen Sie zuerst mithilfe des Einrichtungstools ein Projekt in der Google API Console erstellen und die API aktivieren.
Informationen zu REST-Grundlagen
REST ist eine Art Softwarearchitektur, die einen bequemen und einheitlichen Ansatz zur Abfrage und Bearbeitung von Daten bietet.
Der Begriff REST steht für Representational State Transfer. Im Zusammenhang mit Google-APIs bezieht es sich auf die Verwendung von HTTP-Verben zum Abrufen und Ändern von Darstellungen von Daten, die von Google gespeichert sind.
In einem als "RESTful" bezeichneten System werden Ressourcen in einem Datenspeicher abgelegt; ein Client sendet eine Aufforderung, der Server möge eine bestimmte Aktion ausführen (z. B. eine Ressource erstellen, abfragen, aktualisieren oder löschen), und der Server führt die Aktion aus und sendet eine Antwort, oft in Form einer Darstellung der angegebenen Ressource.
In Googles RESTful APIs spezifiziert der Client eine Aktion mit einem HTTP-Verb wie POST, GET, PUT oder DELETE. Eine Ressource wird anhand eines weltweit eindeutigen URIs im folgenden Format spezifiziert:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Weil alle API-Ressourcen eindeutige, über HTTP zugängliche URIs haben, ermöglicht REST das Caching von Daten und ist optimal geeignet, mit der verteilten Infrastruktur des Webs zu arbeiten.
Dafür können die Methodendefinitionen in der Dokumentation der HTTP 1.1-Standards hilfreich sein. Hier finden Sie auch die Spezifikationen für GET, POST, PUT und DELETE.
REST in der AdMob API
Die AdMob API-Vorgänge sind REST-HTTP-Verben direkt zugeordnet.
Für AdMob API-URIs gelten folgende spezielle Formate:
https://admob.googleapis.com/v1/resourcePath?parameters
Eine vollständige Liste der URIs für jeden unterstützten Vorgang in der API finden Sie im Referenzdokument zur AdMob API.
Informationen zu JSON-Grundlagen
Die AdMob API gibt Daten im JSON-Format zurück.
JSON (JavaScript Object Notation) ist ein gängiges sprachunabhängiges Datenformat, das eine einfache Textdarstellung beliebiger Datenstrukturen bietet. Weitere Informationen finden Sie unter json.org.