Erste Schritte mit der AdMob API

Dieser Leitfaden richtet sich an Entwickler, die mit der AdMob API Daten in ihrem AdMob-Konto möchten.

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.

Führen Sie die folgenden Schritte aus, um die OAuth2-Anmeldedaten zu generieren und Ihre erste Anfrage zu senden.

Vorbereitung

Authentifizierungstyp ermitteln

In der folgenden Tabelle sehen Sie, 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 einziges 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 von einem Computer aus.
Web-App
  • Sie möchten sich als Nutzer authentifizieren, der Ihrer App die Berechtigung zum Zugriff auf seine AdMob API-Kontodaten gewähren kann.
  • Sie möchten ganz einfach mehrere Autorisierungsdaten generieren, um beispielsweise Drittanbieterkonten zu verwalten.
  • Für Ihre App sind Callback-URLs erforderlich. Callback-URLs werden im Ablauf für Desktop-Apps nicht unterstützt.

Projekt erstellen

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

API für ein bestehendes Projekt aktivieren

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

To enable an API for your project:

  1. Open the API Library in the Google API Console.
  2. If prompted, select a project, or create a new one. The API Library lists all available APIs, grouped by product family and popularity.
  3. If the API you want to enable isn't visible in the list, use search to find it, or click View All in the product family it belongs to.
  4. Select the API you want to enable, then click the Enable button.
  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 Sie mit dem Vorgang für installierte Apps verwenden können.

  1. Go to the Credentials page.

  2. Klicken Sie auf ANMELDEDATEN ERSTELLLEN > 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 Einwilligungsbildschirm so zu konfigurieren, dass Ihre OAuth 2.0-Client-ID verwendet wird.

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

    2. Sie können auch den Nutzertyp auf Extern und den Veröffentlichungsstatus auf Testen festlegen. Fügen Sie dann Testnutzer hinzu, 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 finden Sie hier.

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

Anschließend werden Ihnen eine OAuth 2.0-Client-ID und ein Clientschlüssel angezeigt, die Sie im JSON-Format herunterladen und für später 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, eine höhere Sicherheit und Unterstützung für autorisierte Anfragen. Die Clientbibliotheken sind in verschiedenen Programmiersprachen verfügbar. Wenn du sie verwendest, musst du HTTP-Anfragen nicht manuell erstellen und die Antworten nicht manuell parsen.

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 außerdem Informationen zum Umfang:

Umfang Bedeutung
https://www.googleapis.com/auth/admob.readonly Alle AdMob-Daten ansehen Dazu können Kontoinformationen, Inventar- und Vermittlungseinstellungen, Berichte und andere Daten gehören. Nicht enthalten sind sensible Daten wie Zahlungs- und Kampagnendetails.
https://www.googleapis.com/auth/admob.report Rufe Berichte zur Anzeigenleistung und zu Einnahmen auf. Publisher-ID, Zeitzone und Standardwährungscode einsehen

Erstellen Sie Ihre erste Anfrage, um einen Bericht zu generieren. Verwenden Sie dazu Beispiele in Java, PHP, Python oder curl.

Geteilte Tokens widerrufen

Es gibt zwei Möglichkeiten, geteilte Tokens zu widerrufen:

  1. Rufen Sie die Seite mit den Berechtigungen Ihres Google-Kontos auf und widerrufen Sie den Zugriff für das betreffende Projekt.

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