OAuth-Desktop- und -Webanwendungsabläufe

In diesem Leitfaden wird beschrieben, wie du OAuth2 für den API-Zugriff mit deinen eigenen Anmeldedaten und entweder dem Desktop-Ablauf oder dem Webablauf einrichtest. Diese Schritte müssen nur einmal ausgeführt werden, es sei denn, Sie widerrufen, löschen oder ändern die zulässigen Bereiche für Ihre OAuth2-Anmeldedaten.

OAuth2-Anmeldedaten erstellen

  1. Führen Sie die Schritte zur Konfiguration eines Google API Console-Projekts für die Google Ads API aus.

  2. Laden Sie die JSON-Datei des Clients herunter. Klicken Sie dazu zuerst auf das Symbol OAuth-Client herunterladen und dann im nächsten Bildschirm auf die Schaltfläche JSON HERUNTERLADEN.

    Speichern Sie die Datei in Ihrem Basisverzeichnis, sodass Sie jetzt die lokale Datei ~/client_secret_XXX.apps.googleusercontent.com.json haben, wobei XXX die für Ihr Projekt spezifischen Werte sind. Wir verwenden diese Datei im nächsten Schritt, um das Codebeispiel auszuführen.

Clientbibliothek einrichten

  1. Führen Sie in einem Terminal das Beispiel GenerateUserCredentials aus. Verwenden Sie Befehlszeilen-Flags, um die JSON-Datei zu übergeben, die Sie im vorherigen Schritt heruntergeladen haben.

    Ausführung über die Befehlszeile mit Gradle

    ./gradlew --console=plain --quiet runExample \
  --example="authentication.GenerateUserCredentials \
  --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"

  2. In diesem Beispiel werden Sie aufgefordert, eine URL aufzurufen, bei der Sie den OAuth2-Anmeldedaten den Zugriff auf Ihr Google Ads-Konto in Ihrem Namen erlauben müssen.

    Paste this URL in your browser:
https://accounts.google.com/o/oauth2/auth?access_type=offline&client_id=****...

    Rufen Sie die URL in einer privaten Browsersitzung oder einem Inkognitofenster auf. Melden Sie sich mit demselben Google-Konto an, mit dem Sie auch auf Google Ads zugreifen. Klicken Sie auf dem OAuth2-Zustimmungsbildschirm auf Weiter.

    Zustimmungsbildschirm

  3. Sie werden zu einer Seite mit der Meldung weitergeleitet, dass die Autorisierung erfolgreich war.

    Autorisierungscode wurde abgerufen.

    Weitere Informationen finden Sie in der Konsolenausgabe von GenerateUserCredentials.

  4. Kehren Sie zur Konsole zurück, in der Sie das Beispiel ausführen. Sie werden sehen, dass das Beispiel abgeschlossen ist und Ihr Aktualisierungstoken und einige Anweisungen angezeigt werden, gefolgt von den Eigenschaften, die Sie zum Konfigurieren der Clientbibliothek benötigen:

    #Mon Apr 18 09:07:51 EDT 2022
api.googleads.refreshToken=1/Yw.........................................
api.googleads.clientId=...........-...............apps.googleusercontent.com
api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE
api.googleads.clientSecret=........................

  5. Kopieren Sie die Zeilen aus dem Datumskommentar # bis zum Ende der Ausgabe in die Datei ads.properties.

    Ersetzen Sie INSERT_DEVELOPER_TOKEN_HERE durch Ihr Entwicklertoken.

    Legen Sie die Datei ads.properties am einfachsten in Ihrem Basisverzeichnis ab.