Przepływy aplikacji internetowych i komputerowych OAuth

Ostrzeżenie: od wersji 19.0.0 atrybut Biblioteka klienta interfejsu Google Ads API dla .NET będzie nie obsługują już .NET 5.0. Aby zapewnić bezproblemowe działanie, zdecydowanie zalecamy uaktualnisz wersję .NET do końca 2024 r.

Z tego przewodnika dowiesz się, jak skonfigurować protokół OAuth2 na potrzeby dostępu do interfejsów API za pomocą własnego przewodnika dane logowania i proces na komputerze. lub przepływu w witrynie.

Generowanie danych logowania OAuth2 dla jednego konta

Najprostszym sposobem wywoływania kont interfejsu Google Ads API jest

1. Połącz wszystkie konta, dla których chcesz wykonywać wywołania interfejsu API w jednym Konto menedżera Google Ads.

2. Korzystanie z GenerateUserCredentials przykład generowania danych logowania OAuth2 dla użytkownika z dostępem do menedżera koncie.

3. Używaj danych logowania OAuth2 do nawiązywania połączeń ze wszystkimi potrzebnymi kontami za pomocą interfejsu Google Ads API.

Te czynności należy wykonać tylko raz, chyba że je anulujesz, usuniesz lub nie będzie konieczne zmień dozwolone zakresy danych logowania OAuth2.

Krok 1. Utwórz dane logowania OAuth2

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

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

Krok 2. Skonfiguruj bibliotekę klienta

1. W terminalu uruchom GenerateUserCredentials w ramach której na przykład pojawia się prośba o podanie identyfikatora klienta i klucza tajnego OAuth2.

   Jest to przykład interaktywny, który wymaga podania dane wejściowe.

   dotnet run GenerateUserCredentials.csproj
   

2. W przykładzie poprosimy Cię o podanie identyfikatora klienta i tajnego klucza OAuth2. Podaj szczegóły z kroku 1.

3. W tym przykładzie adres URL otwiera się automatycznie w przeglądarce. Jeśli nie masz konta w sesji przeglądarki, wyświetli się prośba o zalogowanie się Konto Google. Jeśli jesteś już zalogowany(-a), logowanie zostanie pominięte. i przekieruje Cię na adres URL, gdzie pojawi się prośba o autoryzację o dostęp do konta Google Ads w Twoim imieniu.

   Uwaga: zaloguj się za pomocą tego samego konta Google, którego używasz do logowania się w Google Ads. Zwykle jest to e-mail logowania na konto menedżera Google Ads, który zawiera w przypadku wszystkich kont, którymi chcesz zarządzać, w ramach ich hierarchii.

   

4. Zostanie wyświetlona strona z komunikatem wskazującym, że udało się przeprowadzić autoryzację.

   Token odświeżania został pobrany. Aby dowiedzieć się więcej, sprawdź dane wyjściowe konsoli za instrukcje.

5. Wróć do konsoli, w której został uruchomiony przykład. Ten przykład powinien zostały wypełnione i wyświetlone zostaną Twój token odświeżania oraz instrukcje, a po nim właściwości potrzebne do skonfigurowania biblioteki 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.
   

Generowanie danych logowania OAuth2 na potrzeby interaktywnych aplikacji

Jeśli nie znasz konta Google Ads, na które należy wywoływać z wyprzedzeniem wywołania interfejsu API, możesz wykrywają go w trakcie działania za pomocą danych logowania użytkownika . Zobacz AuthenticateInAspNetCoreApplication dla przykładu, w którym aktualnie zalogowany użytkownik jest uwierzytelniony, a protokół OAuth2 danych logowania są uzyskiwane w trakcie działania.