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