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

本指南會逐步說明如何使用您自己的憑證、電腦流程或網頁流程，為 API 存取權設定 OAuth2。除非您撤銷、刪除或需要變更 OAuth2 憑證的允許範圍，否則這些步驟只要執行一次。

建立 OAuth2 憑證

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

  2. 請先按一下用戶端的「Download OAuth client」圖示，然後在下一個畫面中點選「Download JSON」(下載 JSON) 按鈕，下載用戶端的 JSON 檔案。

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

設定用戶端程式庫

  1. 在終端機中執行 GenerateUserCredentials 範例。使用指令列旗標來傳送您在上一個步驟下載的 JSON 檔案。

    如何使用 Gradle 透過指令列執行

    ./gradlew --console=plain --quiet runExample \
  --example="authentication.GenerateUserCredentials \
  --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"

  2. 範例會提示您前往某個網址，並需要允許 OAuth2 憑證代您存取 Google Ads 帳戶。

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

    透過私密瀏覽器工作階段或無痕式視窗前往網址。 使用用來存取 Google Ads 的 Google 帳戶登入。按一下 OAuth2 同意畫面上的「繼續」。

    同意畫面

  3. 您將會前往另一個頁面，其中的訊息會指出授權成功。

    已成功擷取授權碼。

    請查看 GenerateUserCredentials 的主控台輸出內容，進一步瞭解詳細操作說明。

  4. 返回執行範例的主控台。您會看到範例已完成，會顯示更新權杖和一些指示，接著設定用戶端程式庫所需的屬性：

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

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

    為簡化設定，請將 ads.properties 檔案放在主目錄中。