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 同意畫面上，按一下「繼續」。

   

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

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