OAuth-Desktop- und -Webanwendungsabläufe

In dieser Anleitung 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 oder löschen die OAuth 2.0-Anmeldedaten oder müssen die zulässigen Bereiche für Ihre OAuth 2.0-Anmeldedaten ändern.

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 Beispiel GenerateUserCredentials aus. Geben Sie die OAuth 2.0-Client-ID und den Clientschlüssel ein, wenn Sie dazu aufgefordert werden.

    dotnet run GenerateUserCredentials.csproj

  2. In diesem Codebeispiel wird eine URL automatisch im Browser geöffnet. Wenn Sie nicht in Ihrer Browsersitzung angemeldet sind, werden Sie auf der Webseite aufgefordert, sich in Ihrem Google-Konto anzumelden. Wenn Sie bereits angemeldet sind, wird die Anmeldeaufforderung übersprungen und Sie werden zu einer URL weitergeleitet, über die Sie der App erlauben müssen, in Ihrem Namen auf Ihr Google Ads-Konto zuzugreifen.

    Melden Sie sich mit dem Google-Konto an, mit dem Sie auf Google Ads zugreifen. In der Regel ist das die Anmelde-E-Mail-Adresse für ein Google Ads-Verwaltungskonto, das alle Konten enthält, die Sie in der zugehörigen Kontohierarchie verwalten müssen. Klicken Sie auf dem OAuth 2.0-Zustimmungsbildschirm auf Weiter.

    OAuth 2.0-Zustimmungsbildschirm

    Sie werden auf eine Seite mit einer Meldung weitergeleitet, die angibt, 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. Der Code ist jetzt fertig und zeigt Ihr Aktualisierungstoken und einige Anweisungen an. Darauf folgen die Anweisungen, die Sie zum Konfigurieren der Clientbibliothek benötigen:

    Copy the following content into your App.config file.

<add key = 'OAuth2Mode' value = 'APPLICATION' />
<add key = 'OAuth2ClientId' value = '******' />
<add key = 'OAuth2ClientSecret' value = '******' />
<add key = 'OAuth2RefreshToken' value = '******' />

    Achten Sie darauf, dass Sie den Header LOGIN_CUSTOMER_ID auch in Ihrer Datei App.config festlegen. Weitere Informationen finden Sie im Konfigurationsleitfaden.

    <add key = 'LoginCustomerId' value = 'INSERT_LOGIN_CUSTOMER_ID_HERE' />

    Informationen zu alternativen Konfigurationsoptionen finden Sie im Konfigurationsleitfaden.

OAuth2-Anmeldedaten für interaktive Anwendungen generieren

Wenn Sie das Google Ads-Konto, für das API-Aufrufe erfolgen sollen, nicht im Voraus kennen, können Sie es zur Laufzeit mit den Anmeldedaten des angemeldeten Nutzers für die Sitzung ermitteln. Ein Beispiel, in dem der aktuell angemeldete Nutzer authentifiziert wird und die OAuth2-Anmeldedaten zur Laufzeit abgerufen werden, finden Sie unter AuthenticateInAspNetCoreApplication.