API-Aufrufe authentifizieren

In diesem Beispiel zeigen wir Ihnen, wie Sie mithilfe von Dienstkonten die AdSense Platforms API aufrufen können, um Unterkonten zu erstellen und zu verwalten.

Schritt 1: Neues Google Cloud-Projekt erstellen oder vorhandenes verwenden

Wenn Sie bereits ein Google Cloud-Projekt haben, können Sie dieses verwenden. Folgen Sie andernfalls der Anleitung unten zum Einrichten eines neuen Projekts:

https://cloud.google.com/resource-manager/docs/creating-managing-projects

Schritt 2: Dienstkonto erstellen

Unterkonten lassen sich am besten über Dienstkonten erstellen. So erstellen Sie Ihr Dienstkonto:

  • Rufen Sie in Google Cloud die Seite Dienstkonten auf.
  • Sie können ein vorhandenes Dienstkonto verwenden oder ein neues erstellen:
    • Klicken Sie auf „+ Dienstkonto erstellen“.
    • Formular „Dienstkontodetails“ ausfüllen
    • Die Schritte 2 und 3 auf der Seite (Zugriff auf Projekte und Nutzer gewähren) sind optional.

Weitere Informationen zum Erstellen und Verwalten von Dienstkonten

Sobald das Dienstkonto erstellt wurde, müssen Sie es an Google senden, damit es Ihrem AdSense-Konto hinzugefügt werden kann. Dies ist wichtig, da das Dienstkonto Zugriff auf Ihr AdSense-Konto haben muss. Teilen Sie dies Ihrem Account Manager mit.

Schritt 3: AdSense Platform API für Ihr Google Cloud-Projekt aktivieren

Die AdSense Platform API ist nicht sichtbar. Das bedeutet, dass Sie den folgenden Link aufrufen müssen, um sie für Ihr Projekt zu aktivieren:

https://console.developers.google.com/apis/api/adsenseplatform.googleapis.com/overview

Schritt 4: Dienstschlüssel erstellen

Um Zugriffstokens für die API-Aufrufe zu generieren, müssen Sie einen Dienstschlüssel erstellen. Gehen Sie hierzu so vor:

  • Rufen Sie in Google Cloud die Seite Dienstkonten auf.
  • Klicken Sie in der Spalte „Aktionen“ des Dienstkontos, mit dem Sie Unterkonten erstellen möchten, auf das und dann auf „Schlüssel verwalten“.
  • Klicken Sie auf „Schlüssel hinzufügen“ und wählen Sie dann „Neuen Schlüssel erstellen“ aus
  • Behalten Sie den Schlüsseltyp „JSON“ bei und klicken Sie auf „Erstellen“
  • Eine JSON-Datei wird erstellt und auf Ihren Computer heruntergeladen. Bewahren Sie diese auf, da sie zur Authentifizierung der API-Aufrufe benötigt wird.

Weitere Informationen zum Erstellen und Verwalten von Dienstkontoschlüsseln

Schritt 5: Mit den OAuth-Bibliotheken von Google ein Zugriffstoken generieren

Google stellt Bibliotheken zur Verfügung, um Zugriffstokens zu generieren, die für die API-Aufrufe verwendet werden können. Informationen zum Generieren von Anmeldedaten für Dienstkonten finden Sie hier:

https://developers.google.com/identity/protocols/oauth2/service-account#authorizingrequests

Die AdSense Platforms API umfasst folgenden Bereich: https://www.googleapis.com/auth/adsense

Beispiel für Python

from google.auth.transport import requests
from google.oauth2 import service_account

CREDENTIAL_SCOPES = ["https://www.googleapis.com/auth/adsense"]
CREDENTIALS_KEY_PATH = 'service.json'

def get_service_account_token():
  credentials = service_account.Credentials.from_service_account_file(
          CREDENTIALS_KEY_PATH, scopes=CREDENTIAL_SCOPES)
  credentials.refresh(requests.Request())
  return credentials.token

Jetzt können Sie die APIs aufrufen. Da Clientbibliotheken für das AdSense Platform-API noch nicht unterstützt werden, müssen stattdessen direkte HTTP-Anfragen gestellt werden. Das Zugriffstoken sollte als Header in die HTTP-Anfrage aufgenommen werden. Die Kopfzeile sollte wie folgt aussehen:

Authorization: OAuth <credentials>

Beispiele finden Sie auf den API-Seiten.