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 pulpitu lub przepływu sieci. Te czynności można wykonać tylko raz, chyba że unieważnisz, usuniesz lub zmienisz dozwolone zakresy danych logowania OAuth2.

Tworzenie danych logowania OAuth2

  1. Wykonaj te czynności, aby skonfigurować projekt w Konsoli interfejsów API Google pod kątem 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, dzięki czemu będziesz mieć plik lokalny ~/client_secret_XXX.apps.googleusercontent.com.json (gdzie XXX będzie wartościami specyficznymi dla Twojego projektu). Wykorzystamy go w następnym kroku do uruchomienia przykładowego kodu.

Konfigurowanie biblioteki klienta

  1. W terminalu uruchom przykład GenerateUserCredentials. Użyj flag wiersza poleceń, aby przekazać do niego plik JSON pobrany w poprzednim kroku.

    Uruchamianie z poziomu wiersza poleceń za pomocą Gradle

    ./gradlew --console=plain --quiet runExample \
      --example="authentication.GenerateUserCredentials \
      --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
    
  2. Wyświetli się prośba o otwarcie adresu URL, pod którym musisz zezwolić danym uwierzytelniającym 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 w sesji przeglądarki prywatnej lub w oknie incognito. Zaloguj się za pomocą tego samego konta Google, którego używasz do logowania się w Google Ads. Na ekranie zgody OAuth2 kliknij Dalej.

    Ekran akceptacji

  3. Otworzy się strona z komunikatem o pomyślnym przeprowadzeniu autoryzacji.

    Kod autoryzacji został pobrany.

    Dalsze instrukcje znajdziesz w danych wyjściowych konsoli z GenerateUserCredentials.

  4. Wróć do konsoli, w której uruchamiasz przykład. Zobaczysz, że przykład został zakończony i wyświetla token odświeżania oraz kilka instrukcji. Zobaczysz 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 od komentarza do daty # na koniec danych wyjściowych do pliku ads.properties.

    Zastąp INSERT_DEVELOPER_TOKEN_HERE swoim tokenem programisty.

    Aby ułatwić sobie konfigurację, umieść plik ads.properties w katalogu głównym.