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

本指南會逐步引導您使用您自己的憑證和電腦流程網頁流程,設定 OAuth2 以存取 API。這些步驟只需執行一次,除非您撤銷、刪除,或是需要變更 OAuth2 憑證的允許範圍。

建立 OAuth2 憑證

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

  2. 先點選用戶端的「Download OAuth client」(下載 OAuth 用戶端) 圖示,然後在下個畫面中點選「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 同意畫面上的「Continue」

    同意畫面

  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 檔案放在主目錄中。