Erste Schritte mit der AdMob API

Wichtig :Neue Nutzerrollen und Berechtigungen wirken sich auf die von der AdMob API zurückgegebenen Daten aus. Weitere Informationen

Diese Anleitung richtet sich an Entwickler, die die AdMob API verwenden möchten, um Daten in ihrem AdMob-Konto programmatisch abzurufen und zu verwalten.

Alle Google AdMob API-Aufrufe müssen über OAuth2 autorisiert werden, damit Ihre App im Namen des Nutzers mit Webdiensten interagieren kann. Mit OAuth2 kann Ihre AdMob API-Client-App auf das AdMob-Konto eines Nutzers zugreifen, ohne dass der Nutzername oder das Passwort des Nutzers verarbeitet oder gespeichert werden muss. Eine Übersicht über die Autorisierung finden Sie unter Autorisierung.

So generieren Sie die OAuth2-Anmeldedaten und stellen Ihre erste Anfrage:

Vorbereitung

• Ein Google-Konto

• Ein Google AdMob-Konto.

• Sie sollten mit den REST-Grundlagen und der Autorisierung von Anfragen mit OAuth 2.0 vertraut sein.

Authentifizierungstyp ermitteln

In der folgenden Tabelle finden Sie Informationen dazu, welcher Authentifizierungstyp für Ihre App am besten geeignet ist:

OAuth2-Authentifizierungstyp auswählen	Wenn…
Desktop-App	Sie verwalten alle Ihre AdMob API-Konten über ein einzelnes Verwaltungskonto der obersten Ebene. Sie sind ein neuer Nutzer oder möchten schnell mit der einfachsten Einrichtung beginnen. Ihre App authentifiziert Google AdMob-Nutzer nur auf einem Computer.
Web-App	Sie möchten sich als Nutzer authentifizieren, der Ihrer App die Berechtigung erteilen kann, auf die Kontodaten der AdMob API zuzugreifen. Sie möchten ganz einfach mehrere Autorisierungsanmeldedaten generieren, um beispielsweise Drittanbieterkonten zu verwalten. Ihre App erfordert Callback-URLs. Callback-URLs werden im Desktop-App-Ablauf nicht unterstützt.

Wichtiger Hinweis :Sie können den Desktop-App-Ablauf auch dann auswählen, wenn Sie eine App entwickeln, die auf einem Server ausgeführt werden soll. Der Unterschied besteht darin, ob die OAuth-Autorisierung lokal oder remote erfolgt. Für einen Desktop-Flow ist eine Autorisierung auf dem lokalen Computer erforderlich, während die Autorisierung beim Web-Flow auf dem Autorisierungsserver von Google erfolgt.

Projekt erstellen

Damit Sie die AdMob API verwenden können, müssen Sie zuerst ein Projekt in der Google API Console erstellen oder auswählen und die API mit dem Einrichtungstool aktivieren. Das Tool führt Sie durch den Prozess und aktiviert die AdMob API automatisch.

API für ein vorhandenes Projekt aktivieren

Die folgenden Schritte gelten für Nutzer, die ein vorhandenes Projekt haben und die AdMob API lieber manuell aktivieren möchten.

So aktivieren Sie eine API für Ihr Projekt:

1. Open the API Library in der Google API Console.
2. If prompted, select a project, or create a new one. In der API Library werden alle verfügbaren APIs nach Produktfamilie und Beliebtheit gruppiert aufgeführt.
3. Wenn die API, die Sie aktivieren möchten, nicht in der Liste angezeigt wird, können Sie die Suchfunktion verwenden oder in der Produktfamilie, zu der sie gehört, auf Alle ansehen klicken.
4. Wählen Sie die gewünschte API aus und klicken Sie dann auf die Schaltfläche Aktivieren.
5. If prompted, enable billing.
6. If prompted, read and accept the API's Terms of Service.

OAuth2-Anmeldedaten erstellen

In der folgenden Anleitung wird beschrieben, wie Sie eine OAuth 2.0-Client-ID erstellen, die mit dem Ablauf für installierte Apps verwendet werden kann.

1. Go to the Credentials page.

2. Klicken Sie auf ANMELDEDATEN ERSTELLEN > OAuth-Client-ID.

   Wenn Sie für dieses Projekt noch keinen OAuth-Zustimmungsbildschirm konfiguriert haben, werden Sie jetzt dazu aufgefordert. Klicken Sie auf ZUSTIMMUNGSBILDSCHIRM KONFIGURIEREN. Es gibt mehrere Möglichkeiten, den Zustimmungsbildschirm für die Verwendung Ihrer OAuth 2.0-Client-ID zu konfigurieren.

   1. Legen Sie den Nutzertyp auf Extern und den Veröffentlichungsstatus auf Veröffentlicht fest.

   2. Alternativ können Sie den Nutzertyp auf Extern und den Veröffentlichungsstatus auf Testen festlegen und dann Testnutzer hinzufügen, indem Sie Nutzer hinzufügen auswählen, um ihnen Zugriff auf Ihre OAuth 2.0-Client-ID zu gewähren.

      Weitere Informationen zum Einrichten des OAuth-Zustimmungsbildschirms

3. Wählen Sie als Anwendungstyp Desktop-App oder Webanwendung aus, geben Sie einen Namen ein und klicken Sie auf Erstellen.

Anschließend erhalten Sie eine OAuth 2.0-Client-ID und einen Clientschlüssel, die Sie im JSON-Format herunterladen und für die spätere Verwendung speichern können.

Anfrage stellen

Die AdMob API basiert auf HTTP und JSON, sodass jeder Standard-HTTP-Client Anfragen an sie senden und die Antworten parsen kann. Die Google API-Clientbibliotheken bieten jedoch eine bessere Sprachintegration sowie eine höhere Sicherheit und unterstützen auch Aufrufe, die eine Autorisierung erfordern. Die Clientbibliotheken sind in verschiedenen Programmiersprachen verfügbar. Wenn Sie sie verwenden, müssen Sie HTTP-Anfragen nicht manuell erstellen und die Antworten nicht manuell parsen.

Hinweis :Wenn Sie den OAuth-Ablauf zum ersten Mal aktivieren, werden Sie aufgefordert, Ihre AdMob-Publisher-ID anzugeben und eine Autorisierungsaufforderung in Ihrem Browser zu akzeptieren. Bevor Sie die Einladung annehmen, müssen Sie sich mit einem Google-Konto anmelden, das Zugriff auf Ihr AdMob-Konto hat. Ihre App ist dann berechtigt, im Namen des jeweils angemeldeten Kontos auf Daten zuzugreifen.

Nachdem Sie OAuth 2.0-Anmeldedaten erstellt haben, können Sie die AdMob API verwenden. Zur Anforderung eines Zugriffs mit OAuth 2.0 benötigt Ihre App auch Bereichsinformationen:

Umfang	Bedeutung
https://www.googleapis.com/auth/admob.readonly	Alle AdMob-Daten ansehen Zu diesen Daten können Ihre Kontoinformationen, Inventar- und Vermittlungseinstellungen, Berichte sowie andere Daten zählen. Nicht enthalten sind sensible Daten wie Zahlungs- und Kampagnendetails.
https://www.googleapis.com/auth/admob.report	Einblick in Leistungsdaten von Anzeigen sowie Abrechnungen Publisher-ID, Zeitzone und Standardwährungscode einsehen.

Stellen Sie Ihre erste Anfrage zum Generieren eines Berichts anhand von Beispielen in Java, PHP, Python oder curl.

Geteilte Tokens widerrufen

Sie haben zwei Möglichkeiten, freigegebene Tokens zu widerrufen:

1. Rufen Sie die Seite mit den Berechtigungen für Ihr Google-Konto auf und widerrufen Sie den Zugriff für das entsprechende Projekt.

2. Alternativ können Sie Webanwendungstokens mit der Google Identity API widerrufen.