OAuth-Playground

Eine Möglichkeit zum Generieren von OAuth2-Anmeldedaten ist der OAuth2 Playground. Mit dem OAuth2 Playground und der Google Ads API Console können Sie OAuth2-Tokens manuell erstellen.

Der OAuth2 Playground eignet sich für Nutzer, die nur auf die Konten eines einzelnen Verwaltungs- oder Google Ads-Nutzers zugreifen müssen. Wenn Sie mehrere Nutzer um Anmeldedaten bitten müssen, ist es wahrscheinlich besser, eine Clientbibliothek für OAuth in Search Ads 360 zu konfigurieren.

Client-ID und Clientschlüssel abrufen

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

Wenn Sie noch kein Cloud-Projekt haben:

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

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 hinzu: 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, mit dem Sie in Ihrem Browser angemeldet sind, bestimmt, auf welche Konten Sie mit den von Ihnen generierten OAuth2-Anmeldedaten zugreifen können. Führen Sie diese Schritte daher in einem Inkognitofenster oder dann aus, wenn Sie nicht in Ihrem Search Ads 360-Konto angemeldet sind. Es ist wahrscheinlich, dass der Nutzer, dessen Anmeldedaten Sie verwenden möchten, nicht derselbe ist, mit dem Sie angemeldet waren, als Sie die Kunden-ID und das Geheime Schlüssel-Objekt erhalten haben.

1. Rufen Sie den OAuth2-Playground auf. Über diesen Link sollten einige wichtige Werte bereits ausgefüllt sein.

2. Klicken Sie oben rechts auf das Zahnradsymbol  und setzen Sie ein Häkchen in das Kästchen Eigene OAuth-Anmeldedaten verwenden, falls noch nicht geschehen.

3. Prüfen Sie Folgendes:

   • OAuth-Ablauf auf Serverseite festgelegt ist.
   • Der Zugriffstyp ist auf Offline festgelegt. Dadurch erhalten Sie ein Aktualisierungstoken und ein Zugriffstoken, anstatt nur ein Zugriffstoken.

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 Bereich aus,https://www.googleapis.com/auth/doubleclicksearch Klicken Sie dann auf APIs autorisieren:

   

6. Melden Sie sich bei Aufforderung in dem Konto an, dem Sie Zugriff und Autorisierung gewähren möchten. Andernfalls prüfen Sie, ob der aktuelle Nutzer oben rechts das Kunden- oder Verwaltungskonto ist, für das Sie Anmeldedaten abrufen möchten.

   Wenn Sie Ihre Client-ID und Ihr Secret erst vor wenigen Minuten erhalten haben und eine Fehlermeldung wie Error: redirect_uri_mismatch (Fehler: redirect_uri_mismatch) erhalten, wurden die von Ihnen vorgenommenen Änderungen möglicherweise noch nicht übernommen. Klicken Sie in Ihrem Browser auf die Schaltfläche „Zurück“, warten Sie einige Minuten und klicken Sie dann noch einmal auf APIs autorisieren.
   Wenn Sie die Fehlermeldung erhalten, dass Ihnen der Entwickler keinen Zugriff gewährt hat und die App derzeit getestet wird, müssen Sie die Seite mit dem OAuth-Zustimmungsbildschirm in Ihrem GCP-Projekt aufrufen und eine der folgenden Aktionen ausführen:

   • Veröffentlichen Sie die App.

   • Lassen Sie die App im Status „Testen“ und fügen Sie sich als Testnutzer hinzu.

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

8. Auf dem Tab Schritt 2 – Autorisierungscode gegen Tokens austauschen sollte ein Autorisierungscode angezeigt werden. Klicken Sie auf Autorisierungscode gegen Tokens austauschen.

   

9. Wenn alles richtig funktioniert, sollten das Aktualisierungstoken und das Zugriffstoken für Sie ausgefüllt sein. Möglicherweise müssen Sie Schritt 2 – Autorisierungscode gegen Tokens austauschen wieder maximieren:

   

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

11. Clientbibliothek für OAuth in der Search Ads 360 Reporting API konfigurieren

OAuth2 Playground aus Client-ID entfernen

Da du jetzt ein Aktualisierungstoken hast, muss der OAuth2-Playground nicht mehr als autorisierter Weiterleitungs-URI festgelegt werden. 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 mindestens eine Weiterleitungs-URI vorhanden sein.

5. Klicken Sie auf Speichern.