API-Aufrufe authentifizieren

In diesem Beispiel wird gezeigt, wie mit Dienstkonten die AdSense Platforms API aufgerufen werden kann, 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 es verwenden. Andernfalls folgen Sie der Anleitung unten, um ein neues Projekt einzurichten:

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

Schritt 2: Dienstkonto erstellen

Die Verwendung von Dienstkonten ist die beste Methode, um Unterkonten zu erstellen. So erstellen Sie ein Dienstkonto:

  • Rufen Sie in Google Cloud die Seite Dienstkonten auf.
  • Sie können entweder 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

Nachdem das Dienstkonto erstellt wurde, müssen Sie es an Google senden, damit es Ihrem AdSense-Konto hinzugefügt werden kann. Das ist wichtig, da das Dienstkonto Zugriff auf Ihr AdSense-Konto haben muss. Bitte wenden Sie sich an Ihren Account Manager.

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

Die AdSense Platform API ist nicht auffindbar. Sie müssen den folgenden Link aufrufen, 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 Verwendung in API-Aufrufen zu generieren, müssen Sie einen Dienstschlüssel erstellen. Gehen Sie so vor:

  • Rufen Sie in Google Cloud die Seite Dienstkonten auf.
  • Klicken Sie in der Spalte „Aktionen“ für das Dienstkonto, mit dem Sie Unterkonten erstellen möchten, auf  und dann auf „Schlüssel verwalten“.
  • Klicken Sie auf „Schlüssel hinzufügen“ und wählen Sie „Neuen Schlüssel erstellen“ aus.
  • Lassen Sie JSON als Schlüsseltyp ausgewählt und klicken Sie auf „Erstellen“.
  • Eine JSON-Datei wird erstellt und auf Ihren Computer heruntergeladen. Bewahren Sie diese Informationen an einem sicheren Ort auf, da sie für die Authentifizierung der API-Aufrufe erforderlich sind.

Weitere Informationen zum Erstellen und Verwalten von Dienstkontoschlüsseln

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

Google stellt Bibliotheken zum Generieren von Zugriffstokens bereit, die für API-Aufrufe verwendet werden können. Weitere Informationen zum Generieren von Anmeldedaten für Dienstkonten finden Sie hier:

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

Der Geltungsbereich der AdSense Platforms API ist: 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

In dieser Phase können Sie die APIs aufrufen. Da Clientbibliotheken für die AdSense Platform API noch nicht unterstützt werden, müssen stattdessen direkte HTTP-Anfragen gestellt werden. Das Zugriffstoken sollte als Header in der HTTP-Anfrage enthalten sein. Der Header sollte so aussehen:

Authorization: OAuth <credentials>

Auf den API-Seiten finden Sie Beispiele.