本指南將逐步引導您設定 OAuth 2.0,以便透過自己的憑證和電腦流程或網頁流程存取 API。除非您撤銷、刪除或需要變更 OAuth 2.0 憑證的允許範圍,否則只需執行一次這些步驟。
建立 OAuth 2.0 憑證
請按照這篇文章的步驟,為 Google Ads API 設定 Google API 控制台專案。
如要下載用戶端的 JSON 檔案,請先按一下「Download OAuth client」圖示,然後點選下列畫面中的「DOWNLOAD JSON」按鈕。
將檔案儲存至主目錄,這樣您現在就擁有本機檔案
~/client_secret_XXX.apps.googleusercontent.com.json
(其中 XXX 為專案專屬值)。我們會在下一個步驟中使用這個檔案來執行程式碼範例。
設定用戶端程式庫
-
在終端機中執行
generate_user_credentials
程式碼範例。使用指令列標記,將您在先前步驟下載的 JSON 檔案傳遞給它。generate_user_credentials.py \ --client_secrets_path=${HOME}/client_secret_XXX.apps.googleusercontent.com.json
-
這個程式碼範例會提示您前往網址,並要求您授權應用程式代您存取 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 同意畫面中按一下「繼續」。
系統會將您導向至顯示授權成功的訊息的頁面。
Your refresh token has been fetched. Check the console output for further instructions.
-
返回執行程式碼範例的控制台。您會看到程式碼範例已完成,並且顯示重新整理權杖和一些操作說明,以及您需要遵循的用戶端程式庫設定操作說明:
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