OAuth-Desktop- und -Webanwendungsabläufe

In dieser Anleitung wird beschrieben, wie Sie OAuth2 für den API-Zugriff mit Ihren eigenen Anmeldedaten und entweder im Desktop-Workflow oder im Web-Flow einrichten.

OAuth2-Anmeldedaten für ein einzelnes Konto generieren

Am einfachsten lassen sich Google Ads API-Konten aufrufen, indem Sie

  1. Verknüpfen Sie alle Konten, an die API-Aufrufe gesendet werden sollen, in einem Google Ads-Verwaltungskonto.

  2. Verwenden Sie das Beispiel GenerateUserCredentials, um OAuth2-Anmeldedaten für einen Nutzer mit Zugriff auf das Verwaltungskonto zu generieren.

  3. Verwenden Sie die OAuth2-Anmeldedaten, um alle Konten aufzurufen, die Sie mit der Google Ads API verwalten müssen.

Diese Schritte müssen nur einmal ausgeführt werden, es sei denn, Sie widerrufen, löschen oder müssen die zulässigen Bereiche für Ihre OAuth2-Anmeldedaten ändern.

Schritt 1: OAuth2-Anmeldedaten erstellen

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

  2. Notieren Sie sich die Client-ID und das Secret und kehren Sie dann zu dieser Seite zurück.

Schritt 2: Clientbibliothek einrichten

  1. Führen Sie in einem Terminal das Beispiel GenerateUserCredentials aus, das Sie zur Eingabe Ihrer OAuth2-Client-ID und Ihres OAuth2-Clientschlüssels auffordert.

    Dies ist ein interaktives Beispiel, bei dem Sie Input bereitstellen müssen.

    dotnet run GenerateUserCredentials.csproj
    
  2. In diesem Beispiel werden Sie aufgefordert, die Client-ID und das Secret für OAuth2 anzugeben. Geben Sie die Details aus Schritt 1 an.

  3. In diesem Beispiel wird eine URL automatisch im Browser geöffnet. Wenn Sie nicht in Ihrer Browsersitzung angemeldet sind, werden Sie auf der Webseite aufgefordert, sich im Google-Konto anzumelden. Wenn Sie bereits angemeldet sind, wird die Anmeldeaufforderung übersprungen und Sie werden zu einer URL weitergeleitet, auf der Sie aufgefordert werden, die Anwendung für den Zugriff auf Ihr Google Ads-Konto zu autorisieren.

    Zustimmungsbildschirm

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

    Ihr Aktualisierungstoken wurde abgerufen. Weitere Anweisungen finden Sie in der Konsolenausgabe.

  5. Kehren Sie zu der Konsole zurück, in der Sie das Beispiel ausgeführt haben. Das Beispiel sollte abgeschlossen sein und Ihr Aktualisierungstoken und eine Anleitung sowie die Attribute enthalten, 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 = '******' />
    
    Make sure you also set the LOGIN_CUSTOMER_ID header. See
    https://developers.google.com/google-ads/api/docs/client-libs/dotnet/configuration#google_ads_api_settings
    to learn more.
    
    <add key = 'LoginCustomerId' value = 'INSERT_LOGIN_CUSTOMER_ID_HERE' />
    
    See https://developers.google.com/google-ads/api/docs/client-libs/dotnet/configuration
    for alternate configuration options.
    

OAuth2-Anmeldedaten für interaktive Anwendungen generieren

Falls Sie das Google Ads-Konto, an das Sie API-Aufrufe vornehmen sollen, nicht im Voraus wissen, können Sie es zur Laufzeit anhand der Anmeldedaten des für die Sitzung angemeldeten Nutzers ermitteln. Unter AuthenticateInAspNetCoreApplication finden Sie ein Beispiel, bei dem der aktuell angemeldete Nutzer authentifiziert und die OAuth2-Anmeldedaten zur Laufzeit abgerufen werden.