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
Wykonaj czynności, aby skonfigurować projekt w Konsoli interfejsów API Google na potrzeby interfejsu Google Ads API.
Zapisz identyfikator klienta i tajny klucz klienta, a potem wróć na tę stronę.
Konfigurowanie biblioteki klienta
-
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
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.
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.
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łówekLOGIN_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
.