Przepływy aplikacji internetowych i komputerowych OAuth

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

  1. Wykonaj czynności, aby skonfigurować projekt w Konsoli interfejsów API Google na potrzeby interfejsu Google Ads API.

  2. Pobierz plik JSON klienta. W tym celu najpierw kliknij ikonę Pobierz klienta OAuth, a potem przycisk POBIERZ JSON na następnym ekranie.

    Zapisz plik w katalogu głównym, aby mieć teraz plik lokalny ~/client_secret_XXX.apps.googleusercontent.com.json (gdzie XXX to wartości specyficzne dla Twojego projektu). Użyjemy tego pliku w następnym kroku, aby uruchomić przykładowy kod.

Konfigurowanie biblioteki klienta

  1. W terminalu uruchom przykładowy kod GenerateUserCredentials. Użyj flag wiersza poleceń, aby przekazać pobrany plik JSON OAuth 2.0.

    Aby uruchomić przykładowy kod z wiersza poleceń za pomocą Gradle, możesz użyć tego polecenia: 
    ./gradlew --console=plain --quiet runExample \
      --example="authentication.GenerateUserCredentials \
      --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"

  2. Ten przykład kodu wyświetli prośbę o otwarcie adresu URL, na którym musisz zezwolić aplikacji na dostęp do Twojego 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ądania prywatnego lub w oknie incognito. 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 musisz zarządzać w ramach jego hierarchii kont. Na ekranie zgody OAuth 2.0 kliknij Dalej.

    Ekran zgody OAuth 2.0

    Przeniesiemy Cię na stronę z komunikatem informującym, że autoryzacja się powiodła.

    Authorization code was successfully retrieved.

Check the console output from `GenerateUserCredentials` for further instructions.

  3. Wróć do konsoli, w której uruchamiasz przykładowy kod. Zobaczysz, że przykład kodu został wykonany i wyświetla token odświeżania oraz instrukcje, a także instrukcje, których musisz przestrzegać, aby skonfigurować bibliotekę 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=........................

  4. Skopiuj wiersze z komentarza do daty # na końcu danych wyjściowych do pliku ads.properties.

    Zastąp INSERT_DEVELOPER_TOKEN_HERE tokenem dewelopera.

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