API-Aufrufe authentifizieren

In diesem Beispiel wird gezeigt, wie Dienstkonten verwendet werden können, um die AdSense Platforms API aufzurufen und Unterkonten zu erstellen und zu verwalten.

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

Wenn Sie bereits ein Google Cloud-Projekt haben, können Sie dieses verwenden. Folgen Sie andernfalls 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 Möglichkeit, Unterkonten zu erstellen. So erstellen Sie Ihr Dienstkonto:

  • Rufen Sie in Google Cloud die Seite Dienstkonten auf.
  • Sie können entweder ein vorhandenes Dienstkonto verwenden oder ein neues erstellen: <ph type="x-smartling-placeholder">
      </ph>
    • Klicken Sie auf „+ Dienstkonto erstellen“.
    • Füllen Sie das Feld „Dienstkontodetails“ aus. Formular
    • Die Schritte 2 und 3 auf dieser 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. Teilen Sie dies bitte Ihrem Account Manager mit.

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

Die AdSense Platform API ist nicht auffindbar. Klicken Sie auf den folgenden Link, 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 den 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, das Sie zum Erstellen von Unterkonten verwenden 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.
  • Lassen Sie JSON als Schlüsseltyp ausgewählt und klicken Sie auf „Erstellen“.
  • Es wird eine JSON-Datei erstellt und auf Ihren Computer heruntergeladen. Bewahren Sie dies an einer sicheren Stelle auf, da es zur Authentifizierung der API-Aufrufe erforderlich ist.

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 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 setzt folgende Bereiche ein: 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 noch nicht für die AdSense Platform API unterstützt werden, müssen stattdessen direkte HTTP-Anfragen gestellt werden. Das Zugriffstoken sollte als Header in der HTTP-Anfrage angegeben werden. Der Header sollte wie folgt aussehen:

Authorization: OAuth <credentials>

Beispiele finden Sie auf den API-Seiten.