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

本指南將逐步引導您設定 OAuth 2.0,以便透過自己的憑證和電腦流程網頁流程存取 API。除非您撤銷、刪除或需要變更 OAuth 2.0 憑證的允許範圍,否則只需執行一次這些步驟。

建立 OAuth 2.0 憑證

  1. 請按照這篇文章的步驟,為 Google Ads API 設定 Google API 控制台專案。

  2. 如要下載用戶端的 JSON 檔案,請先按一下「Download OAuth client」圖示,然後點選下列畫面中的「DOWNLOAD 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