Python 用戶端程式庫託管於 GitHub,套件則可在 PyPI 取得。
需求條件
此程式庫需要 Python 3.8 以上版本。
必要條件
安裝程式庫前,您需要取得開發人員權杖和用戶端客戶 ID。如需取得這些檔案的操作說明,請參閱「必要條件」一節。請注意,您會在後續步驟中產生其他必要的 OAuth2 權杖。
執行階段和依附元件相容性
Python 用戶端程式庫會與 Python Software Foundation 發布的「支援的版本」部分中的 Python 執行階段維持相容性,但狀態為「功能」或「預發布」的版本除外。
採用新版 Python 執行階段時,我們會在該版本發布後的季度結束前,發布與最新執行階段相容的 Python 用戶端程式庫新版本。舉例來說,如果新的執行階段在 10 月發布,則相容的 Python 用戶端程式庫版本會在隔年 3 月底前推出。
系統不會支援已停止支援 (EOL) 的 Python 執行階段,請參閱 python.org 的「Unsupported Versions」一節,瞭解各版本的停止支援日期。
我們可能會在 Python 執行階段達到 EOL 後的任何時間,發布與不支援的 Python 執行階段不相容的 Python 用戶端程式庫版本。
針對依附元件 (特別是任何由 Google 維護,且根據 Google OSS 重大變更政策視為「支援」的 Python 用戶端程式庫所列為必要的套件),我們會維持與 Google 維護的套件相容性,並視為「支援」。
如需支援的 Python 執行階段和依附元件完整清單,請參閱「依附元件」頁面。
安裝
按照安裝說明文件中的指示,從 PyPi 安裝程式庫,然後返回本頁。
設定
安裝程式庫後,您需要為其設定設定。您可以透過多種方式設定程式庫,詳情請參閱設定說明文件。
驗證
選擇設定類型後,您可以繼續產生向 API 提出要求所需的其他 OAuth2 權杖。系統支援多種 OAuth2 流程,請參閱下方清單。如要進一步瞭解兩種流程的差異,以及如何判斷哪種流程最適合您的應用程式,請參閱 OAuth 說明文件。
提出 API 要求
將 OAuth2 權杖納入設定後,即可發出 API 要求。如要瞭解如何簡單測試程式庫是否已正確設定,以便提出 API 要求,請參閱「取得廣告活動」範例。
如要執行 get_campaigns.py
範例,請在本機安裝的 googleads-python
用戶端程式庫的根目錄中執行下列指令:
$ python examples/basic_operations/get_campaigns.py -c \
INSERT_YOUR_CUSTOMER_ID_HERE
其他資源
在您能夠提出 API 要求後,請繼續使用用戶端程式庫: