Python 用戶端程式庫託管於 GitHub,套件則位於 PyPI。
需求條件
這個程式庫需要 Python 3.9 以上版本。
必要條件
繼續閱讀本指南之前,請先取得 Google Ads API 的開發人員權杖,以及 Google Ads 帳戶的 10 位數用戶端客戶 ID。
執行階段和依附元件相容性
Python 用戶端程式庫與 Python 軟體基金會發布的「支援版本」一節中列出的 Python 執行階段保持相容,但狀態為「功能」或「預先發布」的版本除外。
Python Software Foundation 發布並正式支援新版 Python 執行階段後,我們就會採用。
如果 Python 執行階段已停用,則在 python.org 的「Unsupported Versions」(不支援的版本) 專區中,停用日期之後將不再支援。我們無法保證與 EOL 執行階段的相容性,因為我們可能會在 EOL 日期之後的任何時間,發布與這些執行階段不相容的程式庫版本。
對於依附元件 (具體來說,是 Python 用戶端程式庫列為必要的任何 Google 維護套件),我們會維護與 Google 維護套件的相容性,並根據 Google 的 OSS 重大變更政策,將這些套件視為「支援」套件。
如需支援的 Python 執行階段和依附元件完整清單,請參閱「依附元件」頁面。
安裝
我們的安裝指南說明瞭安裝程式庫的所有不同方式。將程式庫安裝至應用程式最簡單 (也是建議) 的方法是使用 pip:
$ python -m pip install google-ads
設定
安裝程式庫後,您需要為程式庫設定配置。設定程式庫的方法有很多種,詳情請參閱設定指南。
驗證
選擇設定方法後,即可設定驗證設定。如需逐步操作說明,請參閱 Python 用戶端程式庫驗證指南,如需更一般的背景資訊,請參閱 OAuth 總覽。
提出 API 要求
設定驗證設定後,即可提出 API 要求。如要快速測試程式庫是否已正確設定,可提出 API 要求,請參閱取得廣告活動範例。
如要執行 get_campaigns.py 範例,請在本機安裝的 googleads-python 用戶端程式庫根目錄中,執行下列指令:
$ python examples/basic_operations/get_campaigns.py -c INSERT_YOUR_CUSTOMER_ID_HERE
其他資源
能夠提出 API 要求後,請繼續瞭解如何使用用戶端程式庫: