總覽

Python 用戶端程式庫託管於 GitHub,套件則可在 PyPI 取得。

需求條件

此程式庫需要 Python 3.8 以上版本。

必要條件

安裝程式庫前,您需要開發人員權杖和用戶端客戶 ID。如要瞭解如何取得這些檔案,請參閱「必要條件」一節。請注意,您會在後續步驟中產生其他必要的 OAuth2 權杖。

執行階段和依附元件相容性

Python 用戶端程式庫會與 Python Software Foundation 發布的「支援的版本」部分中的 Python 執行階段維持相容性,但狀態為「功能」或「預發布」的版本除外。

採用新版 Python 執行階段時,我們會在該版本發布後的當季結束前,發布與最新執行階段相容的 Python 用戶端程式庫新版本。舉例來說,如果新的執行階段在 10 月發布,則相容版本的 Python 用戶端程式庫會在隔年 3 月底前推出。

已停止支援的 Python 執行階段,在 python.org 的「Unsupported Versions」專區中,其「End of Life」日期過後將不再提供支援。

我們可能會在服務終止後,隨時發布與不支援的 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 要求後,請繼續使用用戶端程式庫: