OAuth-Desktop- und -Webanwendungsabläufe

In dieser Anleitung wird beschrieben, wie Sie OAuth2 für den API-Zugriff mit Ihren eigenen Anmeldedaten und entweder mit dem Desktop-Prozess oder dem Web-Ablauf einrichten. Diese Schritte müssen nur einmal ausgeführt werden, sofern Sie die zulässigen Bereiche für Ihre OAuth2-Anmeldedaten nicht widerrufen, löschen oder ändern müssen.

OAuth2-Anmeldedaten erstellen

  1. Führen Sie die Schritte zum Konfigurieren 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 auf dem folgenden Bildschirm auf die Schaltfläche JSON HERUNTERLADEN.

    Speichern Sie die Datei in Ihrem Basisverzeichnis, sodass Sie jetzt über die lokale Datei ~/client_secret_XXX.apps.googleusercontent.com.json verfügen (wobei XXX Werte für Ihr Projekt darstellen). 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, für die Sie den OAuth2-Anmeldedaten den Zugriff auf Ihr Google Ads-Konto in Ihrem Namen gewähren 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 in 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. Es wird eine Seite mit der Meldung angezeigt, dass die Autorisierung erfolgreich war.

    Autorisierungscode wurde abgerufen.

    Weitere Anweisungen finden Sie in der Konsolenausgabe von GenerateUserCredentials.

  4. Kehren Sie zu der Konsole zurück, in der Sie das Beispiel ausführen. Sie sehen, dass das Beispiel abgeschlossen ist und Ihr Aktualisierungstoken und einige Anweisungen angezeigt werden, gefolgt von den Attributen, 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 vom Datumskommentar # bis zum Ende der Ausgabe in die Datei ads.properties.

    Ersetzen Sie INSERT_DEVELOPER_TOKEN_HERE durch Ihr Entwicklertoken.

    Am einfachsten ist es, wenn Sie die Datei ads.properties in Ihrem Basisverzeichnis ablegen.