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. 在終端機中執行 generate_user_credentials程式碼範例。使用指令列標記,將上一步下載的 JSON 檔案傳遞給該工具。

    generate_user_credentials.py \
        --client_secrets_path=${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 同意畫面

    系統會將您導向至授權成功的訊息頁面。

    Your refresh token has been fetched. Check the console output for further instructions.
    
  3. 返回執行程式碼範例的控制台。您會看到程式碼範例已完成,並顯示重新整理權杖和一些操作說明,以及設定用戶端程式庫的操作說明:

    Your refresh token is: 1/Yw.........................................
    Add your refresh token to your client library configuration as described here:
    https://developers.google.com/google-ads/api/docs/client-libs/python/configuration