OAuth-Playground

Eine Möglichkeit zum Generieren von OAuth2-Anmeldedaten ist die Verwendung des OAuth2 Playground. Im OAuth2 Playground können Sie in Verbindung mit der Google Ads API-Konsole manuell OAuth2-Tokens erstellen.

Der OAuth2 Playground ist für Nutzer gedacht, die nur auf die Konten eines einzelnen Verwaltungskontos oder Google Ads-Nutzers zugreifen müssen. Wenn Sie mehrere Nutzer zur Eingabe von Anmeldedaten auffordern müssen, empfiehlt es sich, in Search Ads 360 eine Clientbibliothek für OAuth zu konfigurieren.

Client-ID und Clientschlüssel abrufen

Warnung :Wenn Sie OAuth2 Playground verwenden möchten, müssen Sie eine Client-ID für eine Webanwendung generieren. Dies ist der einzige Anwendungstyp, der mit dem OAuth2 Playground funktioniert. Weitere Informationen finden Sie unter Anwendungstyp auswählen.

Wenn Sie noch kein Cloud-Projekt haben:

1. Öffnen Sie die Google API Console-Seite „Anmeldedaten“.

2. Wählen Sie aus der Drop-down-Liste ein vorhandenes Projekt aus oder erstellen Sie ein neues.

3. Wählen Sie auf der Seite „Anmeldedaten“ die Option Anmeldedaten erstellen und dann OAuth-Client-ID aus.

4. Wählen Sie unter Anwendungstyp den Typ Webanwendung aus.

5. Fügen Sie unter Autorisierte Weiterleitungs-URIs eine Zeile mit folgendem Inhalt ein: https://developers.google.com/oauthplayground

6. Klicken Sie auf Erstellen.

7. Notieren Sie sich auf der Seite "Client-ID" die Client-ID und den Clientschlüssel. Sie benötigen diese Informationen im nächsten Schritt.

Wenn Sie bereits ein Cloud-Projekt haben, können Sie es wiederverwenden, indem Sie die autorisierten Weiterleitungs-URIs wie oben beschrieben festlegen.

Tokens generieren

Warnung :Der Search Ads 360-Nutzer, als der Sie in Ihrem Browser angemeldet sind, bestimmt, auf welche Konten Sie mit den von Ihnen generierten OAuth2-Anmeldedaten zugreifen können. Daher sollten Sie diese Schritte in einem Inkognitofenster oder wenn Sie nicht in Ihrem Search Ads 360-Konto angemeldet sind, ausführen. Es kann nämlich vorkommen, dass der Nutzer, dessen Anmeldedaten Sie verwenden möchten, nicht derselbe Nutzer ist, als Sie angemeldet waren, als Sie die Client-ID und den Clientschlüssel abgerufen haben.

1. Rufen Sie den OAuth2 Playground auf. Über diesen Link sollten einige Schlüssel/Wert-Paare vorab eingefügt werden.

2. Klicken Sie oben rechts auf das Zahnradsymbol und dann auf das Kästchen Use your own OAuthcredentials (Eigene OAuth-Anmeldedaten verwenden), falls es noch nicht aktiviert ist.

3. Prüfen Sie Folgendes:

   • OAuth-Ablauf auf Serverseite festgelegt ist.
   • Zugriffstyp auf Offline festgelegt ist. Dadurch wird sichergestellt, dass Sie ein Aktualisierungstoken und ein Zugriffstoken statt nur eines Zugriffstokens erhalten.

4. Geben Sie die oben notierten Werte für die OAuth2-Client-ID und den OAuth2-Clientschlüssel ein.

   

5. Klicken Sie im Abschnitt Schritt 1 – APIs auswählen und autorisieren in der Liste auf Search Ads 360 Reporting API und wählen Sie den entsprechenden Bereich aus: https://www.googleapis.com/auth/doubleclicksearch. Klicken Sie dann auf Authorize APIs (APIs autorisieren):

   

6. Melden Sie sich bei dem Konto an, dem Sie Zugriff und die Autorisierung gewähren möchten, wenn Sie dazu aufgefordert werden. Bestätigen Sie andernfalls, dass der aktuelle Nutzer rechts oben das Kunden- oder Verwaltungskonto ist, für das Sie die Anmeldedaten abrufen möchten.

   Wenn Sie die Client-ID und das Secret erst vor wenigen Minuten erhalten haben und ein Fehler wie Error: redirect_uri_mismatch angezeigt wird, wurden die vorgenommenen Änderungen möglicherweise nicht übernommen. Klicken Sie im Browser auf die Schaltfläche „Zurück“, warten Sie einige Minuten und klicken Sie dann noch einmal auf APIs autorisieren.
   Wenn Sie eine Fehlermeldung erhalten, dass Ihnen der Zugriff nicht gewährt wurde und die Anwendung gerade getestet wird, müssen Sie die Seite mit dem OAuth-Zustimmungsbildschirm in Ihrem GCP-Projekt aufrufen und einen der folgenden Schritte ausführen:

   • Veröffentlichen Sie die App.

   • Belassen Sie die App im Teststatus und fügen Sie sich selbst als Testnutzer hinzu.

7. Es wird ein Hinweis angezeigt, dass Ihre App Ihre Search Ads 360-Kampagnen verwalten möchte. Klicken Sie auf Akzeptieren, um fortzufahren.

8. Auf dem Tab mit der Bezeichnung Schritt 2 – Autorisierungscode für Tokens austauschen sollte ein Autorisierungscode angezeigt werden. Klicken Sie auf Autorisierungscode gegen Tokens austauschen.

   

9. Wenn alles in Ordnung ist, sollten die Felder Aktualisierungstoken und Zugriffstoken ausgefüllt sein. Möglicherweise müssen Sie Schritt 2 – Autorisierungscode für Tokens austauschen noch einmal maximieren:

   

10. Kopieren Sie das Aktualisierungstoken zusammen mit der Client-ID und dem Clientschlüssel in die Konfigurationsdatei der gewünschten Clientbibliothek.

11. Konfigurieren Sie eine Clientbibliothek für OAuth in der Search Ads 360 Reporting API.

OAuth2 Playground aus Client-ID entfernen

Da Sie jetzt ein Aktualisierungstoken haben, benötigen Sie den OAuth2 Playground nicht mehr als autorisierte Weiterleitungs-URI. So entfernen Sie ihn aus der Liste der autorisierten Weiterleitungs-URIs:

1. Rufen Sie die Seite Google API Console Credentials auf.

2. Wählen Sie Ihr Projekt aus der Drop-down-Liste aus.

3. Klicken Sie auf der Seite "Anmeldedaten" auf den Client-ID-Namen, um Änderungen vorzunehmen.

4. Entfernen Sie https://developers.google.com/oauthplayground aus den autorisierten Weiterleitungs-URIs. Es muss noch mindestens eine Weiterleitungs-URI vorhanden sein.

5. Klicken Sie auf Speichern.