Przepływy pracy aplikacji komputerowych i internetowych OAuth

Z tego przewodnika dowiesz się, jak skonfigurować dostęp OAuth2 do interfejsu API przy użyciu własnych danych logowania oraz procesu pulpitu lub procesu internetowego.

Generowanie danych logowania OAuth2 dla pojedynczego konta

Najłatwiejszym sposobem wywoływania kont na koncie interfejsu API Google Ads jest

  1. Połącz wszystkie konta, do których chcesz wywoływać interfejsy API za pomocą jednego konta menedżera Google Ads.

  2. Użyj przykładu GenerateUserCredentials, aby wygenerować dane logowania OAuth2 dla użytkownika z dostępem do konta menedżera.

  3. Używaj danych logowania OAuth2 do wywoływania wszystkich kont, którymi musisz zarządzać za pomocą interfejsu Google Ads API.

Te kroki musisz wykonać tylko raz, chyba że unieważnisz, usuniesz lub zmienisz dozwolone zakresy danych logowania OAuth2.

Krok 1. Utwórz dane logowania OAuth2

  1. Postępuj zgodnie z instrukcjami konfigurowania projektu w Konsoli interfejsów API Google dla interfejsu Google Ads API.

  2. Zwróć uwagę na identyfikatory klienta i tajne, a potem wróć na tę stronę.

Krok 2. Skonfiguruj bibliotekę klienta

  1. W terminalu uruchom przykład GenerateUserCredentials, który wymaga podania identyfikatora klienta i tajnego klucza OAuth2.

    To interaktywny przykład, w którym musisz podać swoje dane.

    dotnet run GenerateUserCredentials.csproj
    
  2. W podanym przykładzie musisz podać identyfikator klienta i tajny OAuth2. Podaj informacje opisane w kroku 1.

  3. Przykład automatycznie otwiera adres URL w przeglądarce. Jeśli nie zalogujesz się w sesji przeglądarki, na stronie internetowej pojawi się prośba o zalogowanie się na konto Google. Jeśli jesteś już zalogowany, pominie prośbę o zalogowanie i przekieruje Cię na adres URL, pod którym pojawia się prośba o autoryzację dostępu do konta Google Ads z Twojego konta.

    Ekran zgody kontynuuj

  4. Wyświetli się strona z komunikatem o autoryzacji.

    Token odświeżania został pobrany. Dalsze instrukcje znajdziesz w danych wyjściowych w konsoli.

  5. Wróć do konsoli, na której został uruchomiony przykład. W tym przykładzie powinien zostać ukończony token wyświetlania odświeżania i instrukcje, a następnie właściwość, którą musisz skonfigurować:

    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.
    

Generowanie danych logowania OAuth2 dla aplikacji interaktywnych

Jeśli nie znasz konta Google Ads, z którego chcesz wykonywać wywołania interfejsu API, możesz je znaleźć w czasie działania, korzystając z danych logowania zalogowanego użytkownika do sesji. W przykładzie AuthenticateInAspNetCoreApplication opisaliśmy przykład, gdzie aktualnie zalogowany użytkownik jest uwierzytelniany, a dane logowania OAuth2 są pobierane w czasie działania.