Przepływy aplikacji internetowych i komputerowych OAuth

W tym przewodniku znajdziesz instrukcje konfigurowania OAuth 2.0 w celu uzyskiwania dostępu do interfejsu API za pomocą własnych danych logowania oraz przepływu na komputerze lub przepływu w przeglądarce. Wystarczy, że wykonasz te czynności tylko raz, chyba że cofniesz, usuniesz lub zmienisz dozwolone zakresy danych swoich danych logowania OAuth 2.0.

Tworzenie danych logowania OAuth 2.0

  1. Wykonaj czynności opisane w artykule Konfigurowanie projektu w Konsoli interfejsów API Google do obsługi interfejsu Google Ads API.

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

Konfigurowanie biblioteki klienta

  1. W terminalu uruchom przykład GenerateUserCredentials. Gdy pojawi się odpowiedni komunikat, wpisz identyfikator i tajny klucz klienta OAuth 2.0.

    dotnet run GenerateUserCredentials.csproj
    
  2. Ten przykład kodu powoduje automatyczne otwieranie adresu 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(-a), aplikacja pominie prośbę o logowanie i przekieruje Cię na adres URL, na którym musisz zezwolić jej na dostęp do Twojego konta Google Ads.

    Zaloguj się na konto Google, którego używasz do uzyskiwania dostępu do Google Ads. Zwykle jest to adres e-mail logowania do konta menedżera Google Ads, które zawiera wszystkie konta, którymi musisz zarządzać w ramach hierarchii kont. Na ekranie zgody OAuth 2.0 kliknij Dalej.

    Ekran zgody OAuth 2.0

    Przeniesiemy Cię na stronę z komunikatem potwierdzającym, że autoryzacja się powiodła.

    Your refresh token has been fetched. Check the
    console output for further instructions.
  3. Wróć do konsoli, na której uruchamiasz przykład kodu. Zobaczysz, że kod przykładowy został ukończony i wyświetla token odświeżania oraz instrukcje, a zaraz potem instrukcje, których musisz przestrzegać, aby skonfigurować bibliotekę 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 = '******' />
    

    Pamiętaj też, aby w pliku App.config ustawić nagłówek LOGIN_CUSTOMER_ID. Więcej informacji znajdziesz w przewodniku po konfiguracji.

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

    Aby poznać inne opcje konfiguracji, zapoznaj się z przewodnikiem po konfiguracji.

Generowanie danych uwierzytelniających OAuth2 na potrzeby aplikacji interaktywnych

Jeśli nie wiesz, z którego konta Google Ads mają być wykonywane wywołania interfejsu API, możesz je poznać w czasie wykonywania kodu, korzystając z danych logowania użytkownika zalogowanego w danej sesji. Przykładem jest plik AuthenticateInAspNetCoreApplication, w którym uwierzytelniana jest tożsamość aktualnie zalogowanego użytkownika, a dane logowania OAuth2 są uzyskiwane w czasie wykonywania.