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 i procesu na komputerze lub procesu internetowego. Te czynności trzeba wykonać tylko raz, chyba że unieważnisz lub usuniesz albo musisz zmienić dozwolone zakresy danych logowania OAuth2.

Tworzenie danych logowania OAuth2

  1. Postępuj zgodnie z instrukcjami, aby skonfigurować projekt Konsoli interfejsów API Google na potrzeby interfejsu Google Ads API.

  2. Pobierz plik JSON klienta, klikając najpierw ikonę Pobierz klienta OAuth, a następnie przycisk POBIERZ JSON na kolejnym ekranie.

    Zapisz plik w katalogu głównym, tak aby powstał plik lokalny ~/client_secret_XXX.apps.googleusercontent.com.json (gdzie XXX to wartości właściwe dla Twojego projektu). Użyjemy tego pliku w następnym kroku do uruchomienia przykładowego kodu.

Konfigurowanie biblioteki klienta

  1. W terminalu uruchom przykład: GenerateUserCredentials. Za pomocą flag wiersza poleceń przekaż mu plik JSON pobrany w poprzednim kroku.

    Uruchamianie z poziomu wiersza poleceń przy użyciu Gradle

    ./gradlew --console=plain --quiet runExample \
      --example="authentication.GenerateUserCredentials \
      --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
    
  2. W przykładzie wyświetlimy prośbę o otwarcie adresu URL, pod którym trzeba zezwolić danym logowania OAuth2 na dostęp do konta Google Ads w Twoim imieniu.

    Paste this URL in your browser:
    https://accounts.google.com/o/oauth2/auth?access_type=offline&client_id=****...
    

    Otwórz adres URL podczas prywatnej sesji przeglądarki lub okna incognito. Zaloguj się za pomocą konta Google, którego używasz w Google Ads. Kliknij Dalej na ekranie zgody OAuth2.

    Ekran akceptacji

  3. Wyświetli się strona z komunikatem o udanej autoryzacji.

    Kod autoryzacji został pobrany.

    Dalsze instrukcje znajdziesz w danych wyjściowych konsoli GenerateUserCredentials.

  4. Wróć do konsoli, w której korzystasz z przykładu. Zobaczysz, że przykład został ukończony i wyświetli się token odświeżania oraz instrukcje, a potem właściwości potrzebne do skonfigurowania biblioteki klienta:

    #Mon Apr 18 09:07:51 EDT 2022
    api.googleads.refreshToken=1/Yw.........................................
    api.googleads.clientId=...........-...............apps.googleusercontent.com
    api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE
    api.googleads.clientSecret=........................
    
  5. Skopiuj wiersze z komentarza do daty # do końca danych wyjściowych do pliku ads.properties.

    Zastąp INSERT_DEVELOPER_TOKEN_HERE swoim tokenem programisty.

    Najłatwiej jest skonfigurować plik ads.properties w katalogu głównym.