Python 用戶端程式庫託管於 GitHub,套件則可在 PyPI 取得。
需求條件
程式庫支援 Python 3.9 至 3.14 (>=3.9, <3.15;Python 3.14 支援功能已在 v28.2.0 新增)。由於 Python 3.9 和 3.10 在 google-ads v32.0.0 以上版本匯入時會發出淘汰警告,因此建議使用 Python 3.11 以上版本。
必要條件
繼續閱讀本指南前,請先取得 Google Ads 帳戶的 10 位數客戶客戶 ID。
執行階段和依附元件相容性
Python 用戶端程式庫與 Python Software Foundation 發布的「支援版本」一節中的 Python 執行階段相容,但狀態為「功能」或「預先發布版」的版本除外。
Google Ads API 團隊致力於在 Python 軟體基金會發布並正式支援新版 Python 執行階段後,盡快採用。
如果 Python 執行階段已停用,則在 python.org 的「Unsupported Versions」(不支援的版本) 專區中,超過停用日期後就不再支援。我們無法保證與 EOL 執行階段相容,因為在 EOL 日期後發布的程式庫版本可能會破壞相容性。
對於依附元件 (具體來說,是 Python 用戶端程式庫列為必要的任何 Google 維護套件),我們會根據 Google 的 OSS 重大變更政策,維護與 Google 維護且視為「支援」的套件之間的相容性。
如需支援的 Python 執行階段和依附元件完整清單,請參閱「依附元件」頁面。
安裝
安裝指南列出安裝程式庫的所有方式。如要將程式庫安裝到應用程式,最簡單 (且建議) 的方法是使用 pip:
python -m pip install google-ads
設定
安裝程式庫後,您需要為其設定設定檔。設定程式庫的方法有多種,詳情請參閱設定指南。
驗證
選擇設定方法後,請設定驗證設定。如需逐步操作說明,請參閱 Python 用戶端程式庫驗證指南。如需一般背景資訊,請參閱「OAuth 總覽」。
提出 API 要求
設定驗證設定後,即可提出 API 要求。請參閱取得廣告活動範例,快速測試程式庫是否已正確設定,可發出 API 要求。
如要執行 get_campaigns.py 範例,請先複製 google-ads-python 存放區。接著,從複製存放區的根目錄執行下列指令:
python examples/basic_operations/get_campaigns.py -c INSERT_CUSTOMER_ID_HERE
其他資源
確認可以發出 API 要求後,請繼續瞭解如何使用用戶端程式庫: