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 同意畫面中的「繼續」

    同意畫面

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