Z tego przewodnika dowiesz się, jak skonfigurować protokół OAuth2 na potrzeby dostępu przez interfejs API za pomocą własnych danych logowania i procesu na komputerze lub procesu internetowego.
Generowanie danych logowania OAuth2 dla jednego konta
Najprostszym sposobem wywoływania kont interfejsu Google Ads API jest
Połącz wszystkie konta, dla których chcesz wykonywać wywołania interfejsu API, w ramach jednego konta menedżera Google Ads.
Wykorzystaj przykład
GenerateUserCredentials, aby wygenerować dane logowania OAuth2 dla użytkownika z dostępem do konta menedżera.Używaj danych logowania OAuth2 do wywoływania wszystkich kont, którymi musisz zarządzać za pomocą interfejsu Google Ads API.
Te czynności należy wykonać tylko raz, chyba że unieważnisz, usuniesz lub nie będziesz musiał zmienić dozwolonych zakresów danych logowania OAuth2.
Krok 1. Utwórz dane logowania OAuth2
Postępuj zgodnie z instrukcjami, aby skonfigurować projekt Konsoli interfejsów API Google na potrzeby interfejsu Google Ads API.
Zapisz identyfikator klienta i klucz tajny, a potem wróć na tę stronę.
Krok 2. Skonfiguruj bibliotekę klienta
W terminalu uruchom przykładową aplikację
GenerateUserCredentials, która poprosi o identyfikator klienta i klucz tajny OAuth2.Jest to przykład interaktywny, który wymaga podania danych wejściowych.
dotnet run GenerateUserCredentials.csprojW przykładzie poprosimy Cię o podanie identyfikatora klienta i tajnego klucza OAuth2. Podaj szczegóły z kroku 1.
W tym przykładzie adres URL otwiera się automatycznie 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, narzędzie pomija komunikat z prośbą o zalogowanie się i przekieruje Cię pod adres URL z prośbą o autoryzację dostępu aplikacji do konta Google Ads w Twoim imieniu.
Wyświetli się strona z komunikatem o powodzeniu autoryzacji.
Token odświeżania został pobrany. Dalsze instrukcje znajdziesz w danych wyjściowych konsoli.
Wróć do konsoli, w której został uruchomiony przykład. Przykład powinien być już gotowy i zawierać token odświeżania, wraz z instrukcjami oraz właściwościami potrzebnymi 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 wiesz, do którego konta Google Ads należy wywoływać z wyprzedzeniem wywołania interfejsu API, możesz je znaleźć w czasie działania, korzystając z danych logowania zalogowanego użytkownika w sesji. Przykład, w którym obecnie zalogowany użytkownik jest uwierzytelniony, a dane logowania OAuth2 są uzyskiwane w czasie działania, znajdziesz w AuthenticateInAspNetCoreApplication.