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. Notieren Sie sich die Client-ID und den Clientschlüssel und kehren Sie dann zu dieser Seite zurück.

Clientbibliothek einrichten

  1. Führen Sie in einem Terminal das Codebeispiel GenerateUserCredentials aus. Sie werden dann nach Ihrer OAuth 2.0-Client-ID und Ihrem Clientschlüssel gefragt.

    php GenerateUserCredentials.php
    
  2. Im Codebeispiel werden Sie aufgefordert, eine URL aufzurufen, unter der Sie Ihre 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/v2/auth?response_type=code&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.

    Your refresh token has been fetched. Check the console output 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:

    Your refresh token is: 1/Yw**********
    Copy the text below into a file named "google_ads_php.ini" in your home directory, and
      replace "INSERT_DEVELOPER_TOKEN_HERE" with your developer token:
    
    [GOOGLE_ADS]
    developerToken = "INSERT_DEVELOPER_TOKEN_HERE"
    [OAUTH2]
    Copy the following lines to your 'google_ads_php.ini' file:
    clientId = "***********************apps.googleusercontent.com"
    clientSecret = "****"
    refreshToken = "****"