Przepływy aplikacji internetowych i komputerowych OAuth

Z tego przewodnika dowiesz się, jak skonfigurować OAuth2 na potrzeby dostępu API, korzystając z własnych danych logowania oraz z przepływu pracy na komputerze lub przepływu danych z sieci.

Generowanie danych logowania OAuth2 dla jednego konta

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

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

  2. Za pomocą przykładu GenerateUserCredentials możesz wygenerować dane logowania OAuth2 dla użytkownika mającego dostęp do konta menedżera.

  3. Dane logowania OAuth2 umożliwiają wywoływanie wszystkich kont, którymi chcesz zarządzać za pomocą interfejsu Google Ads API.

Opisane tu czynności musisz wykonać tylko raz, chyba że unieważnisz, usuniesz lub zmienisz dozwolone zakresy danych uwierzytelniających OAuth2.

Krok 1. Utwórz dane logowania OAuth2

  1. Wykonaj te czynności, aby skonfigurować projekt w Konsoli interfejsów API Google dla interfejsu Google Ads API.

  2. Zwróć uwagę na identyfikator klienta i klucz tajny, a następnie wróć na tę stronę.

Krok 2. Skonfiguruj bibliotekę klienta

  1. W terminalu uruchom przykład GenerateUserCredentials, w którym wyświetli się prośba o podanie identyfikatora klienta i tajnego klucza OAuth2.

    To jest interaktywny przykład, który wymaga podania danych wejściowych.

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

  3. Ten przykład automatycznie otwiera adres URL w przeglądarce. Jeśli nie jesteś zalogowany(-a) w sesji przeglądarki, na stronie internetowej pojawi się prośba o zalogowanie się na konto Google. Jeśli użytkownik jest już zalogowany, pominie prośbę o zalogowanie się i przekieruje użytkownika na adres URL, pod którym wyświetli się prośba o upoważnienie aplikacji do dostępu do konta Google Ads w jego imieniu.

    Ekran akceptacji

  4. Wyświetli się strona z informacją o udanej autoryzacji.

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

  5. Wróć do konsoli, na której został uruchomiony przykład. Zadanie powinno zakończyć się pomyślnie i wyświetlić token odświeżania wraz z instrukcjami, a następnie podaj właściwości, które musisz skonfigurować w bibliotece klienta:

    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.
    

Wygeneruj dane logowania OAuth2 dla aplikacji interaktywnych

Jeśli nie wiesz, jakie konto Google Ads pozwala na wcześniejsze wywoływanie interfejsu API, możesz je wykryć w czasie działania, korzystając z danych logowania zalogowanego użytkownika. W przykładzie AuthenticateInAspNetCoreApplication znajdziesz przykład sytuacji, w której zalogowany użytkownik jest uwierzytelniony, a dane logowania OAuth2 – uzyskane w czasie działania.