Authentication

Alle Google Ad Manager API-Aufrufe müssen über OAuth2 autorisiert werden. OAuth2 ist ein offener Standard, mit dem Nutzer Drittanbieteranwendungen Berechtigungen erteilen können, damit die Anwendung im Namen des Nutzers mit Webdiensten interagieren kann. Mit OAuth2 kann Ihre Ad Manager API-Clientanwendung auf das Ad Manager-Konto eines Nutzers zugreifen, ohne dass der Nutzername oder das Passwort des Nutzers verarbeitet oder gespeichert werden muss.

OAuth2-Anmeldedaten generieren

Führen Sie die folgenden Schritte aus, um die OAuth2-Anmeldedaten zu generieren.

1. Authentifizierungstyp ermitteln

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

OAuth2-Authentifizierungstyp auswählen
Dienstkonto

Wählen Sie diese Option aus, wenn Sie nur Zugriff auf Ihre eigenen Ad Manager-Daten benötigen.

Weitere Informationen
Webanwendung

Wählen Sie diese Option aus, wenn Sie sich als beliebiger Nutzer authentifizieren möchten, der Ihrer Anwendung die Berechtigung zum Zugriff auf seine Ad Manager-Daten erteilt.

Weitere Informationen

2. OAuth2-Anmeldedaten erstellen

Nachdem Sie den Authentifizierungstyp festgelegt haben, klicken Sie unten auf den entsprechenden Tab und folgen Sie der Anleitung, um die OAuth2-Anmeldedaten zu generieren:

Dienstkonto
  1. Öffnen Sie die Seite „Anmeldedaten“ in der Google API Console.
  2. Wählen Sie im Drop-down-Menü für das Projekt die Option Neues Projekt erstellen aus, geben Sie einen Namen für das Projekt ein und bearbeiten Sie optional die angegebene Projekt-ID. Klicken Sie auf Erstellen.
  3. Wählen Sie auf der Seite „Anmeldedaten“ die Option Anmeldedaten erstellen und dann Dienstkontoschlüssel aus.
  4. Wählen Sie Neues Dienstkonto und dann JSON aus.
  5. Klicken Sie auf Erstellen, um eine Datei mit einem privaten Schlüssel herunterzuladen.
Webanwendung
  1. Öffnen Sie die Seite „Anmeldedaten“ in der Google API Console.
  2. Wählen Sie im Drop-down-Menü des Projekts die Option Neues Projekt erstellen aus, geben Sie einen Namen für das Projekt ein (und bearbeiten Sie optional die angegebene Projekt-ID) und klicken Sie auf Erstellen.
  3. Wählen Sie auf der Seite „Anmeldedaten“ die Option Anmeldedaten erstellen und anschließend OAuth-Client-ID aus.
  4. Möglicherweise werden Sie aufgefordert, auf der Seite „Zustimmungsbildschirm“ einen Produktnamen festzulegen. Klicken Sie in diesem Fall auf Zustimmungsbildschirm konfigurieren, geben Sie die erforderlichen Informationen ein und klicken Sie auf Speichern, um zur Seite „Anmeldedaten“ zurückzukehren.
  5. Wählen Sie Webanwendung als Anwendungstyp aus. Folgen Sie der Anleitung, um JavaScript-Quellen, Weiterleitungs-URIs oder beides einzugeben.
  6. Klicken Sie auf Erstellen.
  7. Kopieren Sie auf der angezeigten Seite die Client-ID und den Clientschlüssel in die Zwischenablage, da Sie sie beim Konfigurieren Ihrer Clientbibliothek benötigen.
Screenshot von Client-ID- und Clientschlüssel

3. Ad Manager-Netzwerk konfigurieren

Wenn Sie ein Drittanbieter-Entwickler sind, müssen Sie diesen Schritt möglicherweise von Ihrem Kunden ausführen lassen.

Dienstkonto
  1. Rufen Sie Ihr Ad Manager-Netzwerk auf.
  2. Klicken Sie auf den Tab Verwaltung.
  3. Achten Sie darauf, dass der API-Zugriff aktiviert ist.
  4. Klicken Sie auf den Button Dienstkontonutzer hinzufügen.
  5. Füllen Sie das Formular mit der E-Mail-Adresse des Dienstkontos aus. Dem Dienstkontonutzer müssen Berechtigungen für den Zugriff auf die Entitäten gewährt werden, so als würde er über die Benutzeroberfläche auf die Entitäten zugreifen.
  6. Klicken Sie auf Speichern. Es sollte eine Meldung angezeigt werden, die das Hinzufügen Ihres Dienstkontos bestätigt.
  7. Sie können vorhandene Dienstkontonutzer aufrufen, indem Sie den Tab „Nutzer“ aufrufen und dann auf den Filter Dienstkonto klicken.
Webanwendung
  1. Rufen Sie Ihr Ad Manager-Netzwerk auf.
  2. Klicken Sie auf den Tab Verwaltung.
  3. Achten Sie darauf, dass der API-Zugriff aktiviert ist.

4. Clientbibliothek konfigurieren und verwenden

Folgen Sie der entsprechenden Anleitung unten, um die Anmeldedaten in Ihrer Clientbibliothek zu verwenden:

Wenn Sie keine unserer Clientbibliotheken verwenden möchten, müssen Sie den OAuth2-Ablauf für Dienstkonten oder Webanwendungen selbst implementieren.

Hinter den Kulissen

Unsere Clientbibliotheken kümmern sich automatisch um die unten beschriebenen Details. Lesen Sie also nur weiter, wenn Sie daran interessiert sind, was hinter den Kulissen passiert. Dieser Abschnitt richtet sich an fortgeschrittene Nutzer, die bereits mit der OAuth2-Spezifikation vertraut sind und wissen, wie sie OAuth2 mit Google APIs verwenden.

HTTP-Anfrageheader

Der HTTP-Header in jeder Anfrage an die Ad Manager API muss ein Zugriffstoken in folgendem Format enthalten:

Authorization: Bearer ACCESS_TOKEN

Beispiel:

POST … HTTP/1.1
Host: …
Authorization: Bearer 1/fFAGRNJru1FTz70BzhT3Zg
Content-Type: text/xml;charset=UTF-8
Content-Length: …

<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope">
…
</soap:Envelope>

Bereich

Ein einzelnes Zugriffstoken kann unterschiedliche Zugriffsebenen für mehrere APIs gewähren. Ein variabler Parameter namens scope steuert die Gruppe von Ressourcen und Vorgängen, die ein Zugriffstoken zulässt. Während der Zugriffstokenanfrage sendet Ihre Anwendung einen oder mehrere Werte im Parameter scope.

Ad Manager hat nur einen Bereich, der unten aufgeführt ist. Die Autorisierung sollte auf Nutzerebene innerhalb des Produkts erfolgen.

Bereich Berechtigungen
https://www.googleapis.com/auth/admanager Kampagnen in Ad Manager ansehen und verwalten