Erste Schritte mit der AdMob API

Dieser Leitfaden richtet sich an Entwickler, die die AdMob API verwenden möchten, um programmatisch Informationen zu ihrem AdMob-Konto abzurufen.

Alle Aufrufe der Google AdMob API müssen über OAuth2 autorisiert werden, damit Ihre App im Namen des Nutzers mit Webdiensten interagieren kann. Mit OAuth2 kann Ihre AdMob API-Clientanwendung auf das AdMob-Konto eines Nutzers zugreifen, ohne den Nutzernamen oder das Passwort des Nutzers verarbeiten oder speichern zu müssen. Eine Übersicht über die Autorisierung finden Sie unter Autorisierung.

Führe die folgenden Schritte aus, um die OAuth2-Anmeldedaten zu generieren und deine erste Anfrage zu senden.

Voraussetzungen

Authentifizierungstyp ermitteln

In der folgenden Tabelle sehen Sie, welcher Authentifizierungstyp für Ihre Anwendung am besten geeignet ist:

OAuth2-Authentifizierungstyp auswählen Wenn…
Desktop-App
  • Sie verwalten alle Ihre AdMob API-Konten mit einem einzigen Verwaltungskonto der obersten Ebene.
  • Sie sind ein neuer Nutzer oder möchten mit der einfachsten Einrichtung schnell loslegen.
  • 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 erteilen kann, auf seine AdMob API-Kontodaten zuzugreifen.
  • Sie möchten auf einfache Weise mehrere Autorisierungsanmeldedaten generieren, um beispielsweise Drittanbieterkonten zu verwalten.
  • Ihre Anwendung erfordert Callback-URLs. Callback-URLs werden im Workflow für Desktopanwendungen nicht unterstützt.

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 Sie durch den Vorgang führt und die AdMob API automatisch aktiviert.

API für ein vorhandenes Projekt aktivieren

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

So aktivieren Sie eine API für Ihr Projekt:

  1. Open the API Library im Google API Console .
  2. If prompted, select a project, or create a new one. Der API Library listet alle verfügbaren APIs auf, gruppiert nach Produktfamilie und Beliebtheit.
  3. Wenn die API, die Sie aktivieren möchten, in der Liste nicht sichtbar ist, suchen Sie sie mithilfe der Suche oder klicken Sie in der Produktfamilie, zu der sie gehört, auf Alle anzeigen.
  4. Wählen Sie die API Sie aktivieren möchten, und klicken Sie 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 für den Ablauf installierter Anwendungen erstellen.

  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. Setzen Sie den Nutzertyp auf Extern und den Veröffentlichungsstatus auf Veröffentlicht.

    2. Alternativ können Sie den Nutzertyp auf Extern und den Veröffentlichungsstatus auf Test setzen und dann Testnutzer hinzufügen. Wählen Sie dazu Nutzer hinzufügen aus, 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, benennen Sie die Anwendung und klicken Sie auf Erstellen.

Wenn Sie fertig sind, werden eine OAuth 2.0-Client-ID und ein Clientschlüssel angezeigt, 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 HTTP-Standardclient 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 autorisierte Anfragen. Die Clientbibliotheken sind in verschiedenen Programmiersprachen verfügbar. Wenn Sie sie verwenden, müssen Sie HTTP-Anfragen nicht manuell einrichten und die Antworten nicht manuell parsen.

Nachdem Sie OAuth 2.0-Anmeldedaten erstellt haben, können Sie die AdMob API verwenden. Um den Zugriff mit OAuth 2.0 anzufordern, benötigt Ihre Anwendung außerdem Informationen zum Bereich:

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 Anzeigenleistung und Einnahmenberichte aufrufen Siehe Publisher-ID, Zeitzone und Standardwährungscode.

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

Geteilte Token widerrufen

Sie können freigegebene Tokens auf zwei Arten widerrufen:

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

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