總覽

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 執行階段達到生命週期終止 (EOL) 後,就不再支援 python.org 的「Unsupported Versions」(不支援的版本) 部分中 EOL 日期之後的版本。我們無法保證與 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 要求後,請繼續使用用戶端程式庫: