OAuth 電腦和網頁應用程式流程

本指南將逐步說明如何使用自己的憑證，透過桌面流程或網頁流程設定 OAuth 2.0，以存取 API。除非您撤銷或刪除 OAuth 2.0 憑證，或需要變更允許的範圍，否則這些步驟只需執行一次。

建立 OAuth 2.0 憑證

  1. 請按照步驟為 Google Ads API 設定 Google API 控制台專案。

  2. 依序點選用戶端的「下載 OAuth 用戶端」圖示和下一個畫面中的「下載 JSON」按鈕，即可下載用戶端的 JSON 檔案。

    將檔案儲存至主目錄，這樣您現在就會有本機檔案 ~/client_secret_XXX.apps.googleusercontent.com.json (其中 XXX 會是專案專屬的值)。我們會在下一個步驟中使用這個檔案，執行程式碼範例。

設定用戶端程式庫

  1. 在終端機中執行 GenerateUserCredentials 程式碼範例。使用指令列標記，將您下載的 OAuth 2.0 JSON 檔案傳遞給該工具。

    您可以使用下列指令，透過 Gradle 從指令列執行程式碼範例： 
    ./gradlew --console=plain --quiet runExample \
      --example="authentication.GenerateUserCredentials \
      --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"

  2. 這個程式碼範例會提示您前往網址，您必須授權應用程式代為存取 Google Ads 帳戶。

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

    在私密瀏覽工作階段或無痕視窗中前往該網址。使用您用來存取 Google Ads 的 Google 帳戶登入。通常這是 Google Ads 管理員帳戶的登入電子郵件，其中包含您需要在帳戶階層中管理的所有帳戶。在 OAuth 2.0 同意畫面上，按一下「繼續」。

    OAuth 2.0 同意畫面

    系統會將您帶往一個頁面，並顯示授權成功的訊息。

    Authorization code was successfully retrieved.

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

  3. 返回執行程式碼範例的控制台。您會看到程式碼範例已完成，並顯示重新整理權杖和一些操作說明，接著是設定用戶端程式庫的操作說明：

        #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. 將日期註解 # 到輸出內容結尾的程式碼行，複製到 ads.properties 檔案中。

    將 INSERT_DEVELOPER_TOKEN_HERE 替換為您的開發人員權杖。

    如要簡化設定程序，請將 ads.properties 檔案放在主目錄中。