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 同意畫面上的「Continue」

    同意畫面

  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