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 przepływu pracy na komputerze lub przepływu witryny.

Generowanie danych logowania OAuth2 dla pojedynczego konta

Najprostszym sposobem wywoływania kont interfejsu Google Ads API jest

1. Połącz wszystkie konta, na których chcesz wywoływać interfejs 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 chcesz zarządzać za pomocą interfejsu Google Ads API.

Te czynności należy wykonać tylko raz, chyba że unieważnisz, usuniesz lub zmienisz dozwolone zakresy danych logowania OAuth2.

Krok 1. Utwórz dane logowania OAuth2

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

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

Krok 2. Skonfiguruj bibliotekę klienta

1. W terminalu uruchom przykład GenerateUserCredentials, aby uzyskać identyfikator klienta OAuth2 i tajny klucz.

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

   dotnet run GenerateUserCredentials.csproj
   

2. W tym przykładzie musisz podać identyfikator klienta i obiekt tajny OAuth2. Podaj informacje z kroku 1.

3. W tym przykładzie adres URL jest automatycznie otwierany 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), komunikat o logowaniu zostanie pominięty i zostanie przekierowany pod adres URL, pod którym zostanie wyświetlona prośba o autoryzowanie aplikacji dostępu do konta Google Ads w Twoim imieniu.

   Uwaga: zaloguj się na konto Google, którego używasz w Google Ads. Zwykle jest to adres e-mail używany do logowania na konto menedżera Google Ads, które zawiera wszystkie konta w hierarchii konta, którymi musisz zarządzać.

   

4. Zostanie wyświetlona strona z komunikatem o pomyślnej autoryzacji.

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

5. Wróć do konsoli, w której uruchomiono przykład. W przykładzie powinien się pojawić token odświeżania oraz instrukcje 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.
   

Generowanie danych logowania OAuth2 dla aplikacji interaktywnych

Jeśli nie wiesz, na jakim koncie Google Ads wykonywać wywołania interfejsu API z wyprzedzeniem, możesz wykryć je w czasie działania, korzystając z danych logowania zalogowanego użytkownika na daną sesję. 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.