Przepływy aplikacji internetowych i komputerowych OAuth

Z tego przewodnika dowiesz się, jak skonfigurować protokół OAuth2 na potrzeby dostępu do interfejsu API przy użyciu własnych danych logowania oraz procesu witryny na komputery lub procesu internetowego.

Generowanie danych logowania OAuth2 dla pojedynczego konta

Najprostszym sposobem na wywoływanie kont interfejsu Google Ads API jest

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

2. Skorzystaj z 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 zarządzasz za pomocą interfejsu Google Ads API.

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

Krok 1. Utwórz dane uwierzytelniające OAuth2

1. Wykonaj te czynności, aby skonfigurować projekt Konsoli interfejsów API Google pod kątem 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 przykład GenerateUserCredentials, który poprosi 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 przykładzie poprosimy Cię o podanie identyfikatora klienta i tajnego protokołu OAuth2. Podaj szczegóły z kroku 1.

3. Ten 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ż zalogowanym użytkownikiem, system pominie prośbę o zalogowanie i przekieruje Cię na adres URL, pod którym pojawi się prośba o autoryzację aplikacji dostępu do konta Google Ads w Twoim imieniu.

   Uwaga: zaloguj się za pomocą tego samego konta Google, którego używasz w Google Ads. Zwykle jest to e-mail logowania na konto menedżera Google Ads, które zawiera wszystkie konta w hierarchii konta.

   

4. Wyświetli się strona z komunikatem, że autoryzacja się powiodła.

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

5. Wróć do konsoli, w której uruchomiono przykład. Przykład powinien być zakończony. Musi zawierać token odświeżania wraz z instrukcjami oraz 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.
   

Wygeneruj dane uwierzytelniające OAuth2 dla aplikacji interaktywnych

Jeśli nie wiesz, jakie konto Google Ads służy do wykonywania wywołań interfejsu API, możesz je wykryć w czasie działania dzięki danym logowania zalogowanego użytkownika na potrzeby danej sesji. W sekcji AuthenticateInAspNetCoreApplication znajdziesz przykład sytuacji, w której obecnie zalogowany użytkownik jest uwierzytelniony, a dane logowania OAuth2 są uzyskiwane w czasie działania.