Bevor Sie mit der Codierung Ihrer ersten Client-Anwendung beginnen, müssen Sie einige Vorbereitungen treffen (falls noch nicht geschehen).
Erstellen Sie sich ein Google-Konto
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.
Sie können auch ein separates Google-Konto zu Testzwecken verwenden.
Testen Sie Google AdMob
In dieser API-Dokumentation wird davon ausgegangen, dass Sie Google AdMob verwendet haben und mit Webprogrammierung und Webdatenformaten vertraut sind.
Falls Sie Google AdMob noch nicht verwendet haben, probieren Sie die Benutzeroberfläche aus, bevor Sie mit dem Codieren beginnen.
Projekt für den Client erstellen
Bevor Sie Anfragen an Google AdMob senden können, müssen Sie Google über Ihren Kunden informieren und den Zugriff auf die API aktivieren. Dazu erstellen Sie mit der Google API Console ein Projekt, bei dem es sich um eine benannte Sammlung von Einstellungen und API-Zugriffsinformationen handelt, und um Ihre Anwendung zu registrieren.
Wenn Sie die AdMob API verwenden möchten, müssen Sie zuerst das Einrichtungstool verwenden. Dieses Tool führt Sie durch die Erstellung eines Projekts in der Google API Console, die Aktivierung der API und die Erstellung von Anmeldedaten.
Informationen zu REST-Grundlagen
REST ist eine Art Softwarearchitektur, die einen bequemen und einheitlichen Ansatz zur Abfrage und Bearbeitung von Daten bietet.
REST steht für "Representational State Transfer". Im Kontext der Google APIs ist damit die Verwendung von HTTP-Verben gemeint, um Darstellungen von Daten, die bei Google gespeichert sind, abzufragen und zu bearbeiten.
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 den RESTful APIs von Google gibt der Client eine Aktion mit einem HTTP-Verb wie POST, GET, PUT oder DELETE an. Die Ressource wird durch einen global eindeutigen URI der folgenden Form angegeben:
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 spezifische Formate:
https://admob.googleapis.com/v1/resourcePath?parameters
Die vollständige Gruppe von URIs, die für die einzelnen unterstützten Vorgänge in der API verwendet wird, ist im Dokument AdMob API-Referenz zusammengefasst.
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.