Przepływy aplikacji internetowych i komputerowych OAuth

Z tego przewodnika dowiesz się, jak skonfigurować OAuth 2.0 na potrzeby dostępu do interfejsu API za pomocą własnych danych logowania i przepływu na komputerze lub przepływu w internecie. Wystarczy, że tylko raz wykonasz te kroki, chyba że cofniesz lub usuniesz dane logowania OAuth 2.0 albo będziesz musiał zmienić dozwolone zakresy.

Tworzenie danych logowania OAuth 2.0

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

  2. Zapisz identyfikator klientatajny klucz klienta, a potem wróć na tę stronę.

Konfigurowanie biblioteki klienta

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

    dotnet run GenerateUserCredentials.csproj
    
  2. Ten przykład kodu automatycznie otwiera adres URL w przeglądarce. Jeśli nie zalogujesz się w sesji przeglądarki, na stronie pojawi się prośba o zalogowanie się na konto Google. Jeśli jesteś już zalogowany(-a), pominiemy prośbę o zalogowanie się i przekierujemy Cię na adres URL, na którym musisz autoryzować aplikację, aby mogła uzyskać dostęp do Twojego konta Google Ads w Twoim imieniu.

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

    Ekran zgody OAuth 2.0

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

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

    Upewnij się, że w pliku App.config ustawiono też nagłówek LOGIN_CUSTOMER_ID. Więcej informacji znajdziesz w przewodniku po konfiguracji.

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

    Alternatywne opcje konfiguracji znajdziesz w przewodniku po konfiguracji.

Generowanie danych logowania OAuth2 dla aplikacji interaktywnych

Jeśli nie znasz z wyprzedzeniem konta Google Ads, do którego chcesz wysyłać wywołania interfejsu API, możesz je wykryć w czasie działania programu, używając danych logowania użytkownika zalogowanego w sesji. Przykład, w którym zalogowany użytkownik jest uwierzytelniany, a dane logowania OAuth2 są uzyskiwane w czasie działania programu, znajdziesz w sekcji AuthenticateInAspNetCoreApplication.