OAuth-Desktop- und -Webanwendungsabläufe

In diesem Leitfaden erfahren Sie, wie Sie OAuth 2.0 für den API-Zugriff mit Ihren eigenen Anmeldedaten und entweder dem Desktop-Ablauf oder dem Web-Ablauf einrichten. 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 OAuth 2.0-Anmeldedaten.

OAuth 2.0-Anmeldedaten erstellen

  1. Folgen Sie der Anleitung, um ein Google API Console-Projekt für die Google Ads API zu konfigurieren.

  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 die lokale Datei ~/client_secret_XXX.apps.googleusercontent.com.json haben (XXX sind Werte, die für Ihr Projekt spezifisch sind). Diese Datei verwenden wir im nächsten Schritt, um das Codebeispiel auszuführen.

Clientbibliothek einrichten

  1. Führen Sie in einem Terminal das Codebeispiel GenerateUserCredentials aus. Übergeben Sie mit Befehlszeilen-Flags die heruntergeladene OAuth 2.0-JSON-Datei.

    Mit dem folgenden Befehl können Sie das Codebeispiel über die Befehlszeile mit Gradle ausführen:
    ./gradlew --console=plain --quiet runExample \
          --example="authentication.GenerateUserCredentials \
          --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
        
  2. In diesem Codebeispiel werden Sie aufgefordert, eine URL aufzurufen, unter der Sie die App autorisieren müssen, in Ihrem Namen auf Ihr Google Ads-Konto zuzugreifen.

    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 dem Google-Konto an, mit dem Sie auf Google Ads zugreifen. In der Regel ist dies die Anmelde-E-Mail-Adresse für ein Google Ads-Verwaltungskonto, das alle Konten enthält, die Sie in der Kontohierarchie verwalten müssen. Klicken Sie auf dem OAuth 2.0-Zustimmungsbildschirm auf Weiter.

    OAuth 2.0-Zustimmungsbildschirm

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

    Authorization code was successfully retrieved.
    
    Check the console output from `GenerateUserCredentials` for further instructions.
        
  3. Kehren Sie zur Konsole zurück, in der Sie das Codebeispiel ausführen. Das Codebeispiel ist jetzt fertig und zeigt Ihr Aktualisierungstoken und einige Anweisungen an, gefolgt von der Anleitung zum Konfigurieren der Clientbibliothek:

        #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=........................
        
  4. Kopieren Sie die Zeilen vom Datumskommentar # bis zum Ende der Ausgabe in die ads.properties-Datei.

    Ersetzen Sie INSERT_DEVELOPER_TOKEN_HERE durch Ihr Entwicklertoken.

    Die Einrichtung ist am einfachsten, wenn Sie die ads.properties-Datei in Ihrem Basisverzeichnis ablegen.