Przepływy aplikacji internetowych i komputerowych OAuth

W tym przewodniku znajdziesz instrukcje konfigurowania OAuth 2.0 w celu uzyskiwania dostępu do interfejsu API za pomocą własnych danych logowania oraz przepływu na komputerze lub przepływu w przeglądarce. Wystarczy wykonać te czynności tylko raz, chyba że cofniesz, usuniesz lub zmienisz dozwolone zakresy danych swoich danych logowania OAuth 2.0.

Tworzenie danych logowania OAuth 2.0

  1. Wykonaj czynności opisane w artykule Konfigurowanie projektu w Konsoli interfejsów API Google do obsługi interfejsu Google Ads API.

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

    Zapisz plik w katalogu domowym, aby mieć lokalny plik ~/client_secret_XXX.apps.googleusercontent.com.json (gdzie XXX to wartości specyficzne dla Twojego projektu). W następnym kroku użyjemy tego pliku do uruchomienia przykładowego kodu.

Konfigurowanie biblioteki klienta

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

    Aby uruchomić przykładowy kod z poziomu wiersza poleceń za pomocą Gradle, użyj tego polecenia:
    ./gradlew --console=plain --quiet runExample \
          --example="authentication.GenerateUserCredentials \
          --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
        
  2. Ten przykład kodu spowoduje wyświetlenie adresu URL, pod 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ądarki prywatnej 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 do logowania na konto menedżera Google Ads, które zawiera wszystkie konta, którymi musisz zarządzać w ramach hierarchii kont. Na ekranie zgody OAuth 2.0 kliknij Dalej.

    Ekran zgody OAuth 2.0

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

    Authorization code was successfully retrieved.
    
    Check the console output from `GenerateUserCredentials` for further instructions.
        
  3. Wróć do konsoli, na której uruchamiasz przykład kodu. Zobaczysz, że przykład kodu został ukończony i wyświetla token odświeżania oraz instrukcje, a następnie 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 od komentarza z datą # do końca danych wyjściowych do pliku ads.properties.

    Zastąp INSERT_DEVELOPER_TOKEN_HERE swoim tokenem dewelopera.

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