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. 在終端機中執行 generate_user_credentials 範例。使用指令列標記來傳遞您在上一個步驟中下載的 JSON 檔案。

    generate_user_credentials.py \
      --client_secrets_path=${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. 系統會將您導向另一個頁面,其中會顯示授權成功的訊息。

    已擷取更新權杖。如需進一步說明,請參閱主控台輸出內容。

  4. 返回執行範例的主控台,此時應該會顯示更新權杖,以及設定用戶端程式庫的操作說明:

    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