本指南將逐步說明如何使用自己的憑證以及電腦版流程或網頁流程,設定 OAuth2 存取 API 存取權。這些步驟只需執行一次,除非您撤銷、刪除或需要變更 OAuth2 憑證允許的範圍。
建立 OAuth2 憑證
請按照這篇文章中的步驟,為 Google Ads API 設定 Google API 控制台專案。
在下一個畫面中,按一下「Download OAuth client」(下載 OAuth 用戶端) 圖示,然後點選「Download JSON」(下載 JSON) 按鈕,下載用戶端的 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
此範例會提示您前往一個網址,您必須在該網址允許 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 同意畫面中的「繼續」。
系統會將您導向另一個頁面,其中會顯示授權成功的訊息。
已擷取更新權杖。如需進一步說明,請參閱主控台輸出內容。
返回執行範例的主控台,此時應該會顯示更新權杖,以及設定用戶端程式庫的操作說明:
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