Dieser Leitfaden richtet sich an Entwickler, die die AdMob API verwenden möchten, um in ihrem AdMob-Konto 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 den Nutzernamen oder das Passwort des Nutzers verarbeiten oder speichern zu müssen. 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.
Voraussetzungen
Ein Google-Konto
Ein Google AdMob-Konto.
Sie sollten mit den Grundlagen von REST und der Autorisierung von Anfragen mit OAuth 2.0 vertraut sein.
Authentifizierungstyp ermitteln
Der folgenden Tabelle können Sie entnehmen, welcher Authentifizierungstyp für Ihre Anwendung am besten geeignet ist:
OAuth2-Authentifizierungstyp auswählen | Wenn… |
---|---|
Desktop-App |
|
Web-App |
|
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 mithilfe des Einrichtungstools 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 bestehendes Projekt haben und die AdMob API dafür manuell aktivieren möchten.
为您的项目启用API:
- Open the API Library中的Google API Console 。
- If prompted, select a project, or create a new one. API Library列出了所有可用的API,并按产品家族和受欢迎程度分组。
- 如果您要启用的API在列表中不可见,请使用搜索找到它,或单击其所属产品系列中的“ 查看全部 ”。
- 选择要启用的API,然后单击“ 启用”按钮。
- If prompted, enable billing.
- 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.
- Go to the Credentials page.
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 ZUSTIMMENBILDSCHIRM KONFIGURIEREN. Es gibt mehrere Möglichkeiten, den Einwilligungsbildschirm so zu konfigurieren, dass Ihre OAuth 2.0-Client-ID verwendet wird.
- Setzen Sie den Nutzertyp auf Extern und den Veröffentlichungsstatus auf Veröffentlicht.
Sie können auch 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 finden Sie hier.
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 |
Anzeigenleistung und Einnahmenberichte ansehen 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:
Rufen Sie die Seite mit den Berechtigungen Ihres Google-Kontos auf und widerrufen Sie den Zugriff für das betreffende Projekt.
Alternativ können Sie Webanwendungstokens mit der Google Identity API widerrufen.