google api python client

GoogleAPI客戶端

這是用於 Google 基於發現的 API 的 Google API Python 用戶端程式庫。若要開始使用，請參閱 docs 資料夾。

該庫被認為是完整的並且處於維護模式。這意味著我們將解決關鍵錯誤和安全問題，但不會添加任何新功能。

該庫由 Google 官方支援。但是，此儲存庫的維護者建議在可能的情況下使用適用於 Python 的雲端客戶端程式庫進行新程式碼開發。欲了解更多信息，請訪問客戶端庫解釋。

2.0版本發布

與 1.x 相比， google-api-python-client 2.0 版本的可靠性得到了顯著改進，因為發現文件現在緩存在庫中而不是動態獲取。強烈建議從 v1.x 升級到 v2.x。

僅支援 python 3.7 及更高版本。如果您無法升級 python，請繼續使用 1.x 版本，因為我們將在 v1 中繼續支援 python 2.7+。

當您呼叫discovery.build()時，將不再動態檢索發現文件。發現文件將直接從客戶端庫檢索。該庫的新版本每週發布一次。由於快取了發現文檔，該套件的大小比以前的版本至少大 50 MB。

請參閱遷移指南以了解更多資訊。

文件

請參閱 docs 資料夾以取得更詳細的說明和其他文件。

其他 Google API 庫

由於以下原因，此儲存庫的維護者建議在可能的情況下使用適用於 Python 的雲端客戶端程式庫進行新程式碼開發：

使用適用於 Python 的雲端客戶端程式庫：

• 每個 API 都有一個單獨的客戶端程式庫，因此您可以選擇下載哪些客戶端程式庫。而google-api-python-client是適用於所有 API 的單一客戶端程式庫。因此， google-api-python-client的總套件大小超過 50MB。
• 由於每個客戶端庫都專注於特定的 API，因此對底層 API 的重大變更有更嚴格的控制。
• 這些雲端客戶端庫中有更多功能，因為每個程式庫都專注於特定的 API，並且在某些情況下，這些程式庫由專門研究該 API 的團隊擁有。
• 開發人員將從智慧感知中受益。

欲了解更多信息，請訪問客戶端庫解釋。

儘管遷移到 Python 雲端客戶端程式庫有很多好處，但維護者希望強調google-api-python-client將繼續受到支援。

對於 Google Ads API，我們建議使用適用於 Python 的 Google Ads API 用戶端程式庫。

對於 Google Firebase Admin API，我們建議使用 Firebase Admin Python SDK。

安裝

使用 pip 在 vi​​rtualenv 中安裝此程式庫。 virtualenv 是一個創建隔離的 Python 環境的工具。它解決的基本問題是依賴關係和版本以及間接權限之一。

使用 virtualenv，可以在不需要係統安裝權限的情況下安裝此程式庫，並且不會與已安裝的系統相依性發生衝突。

蘋果電腦/Linux

pip3 install virtualenv
virtualenv < your-env >
source < your-env > /bin/activate
< your-env > /bin/pip install google-api-python-client

視窗

pip install virtualenv
virtualenv < your-env >
< your-env > Scriptsactivate
< your-env > Scriptspip.exe install google-api-python-client

支援的 Python 版本

Python 3.7、3.8、3.9、3.10、3.11 和 3.12 完全支援和測試。該庫可能適用於 3 的更高版本，但我們目前不會針對這些版本執行測試。

不受支援的 Python 版本

Python < 3.7

第三方函式庫和依賴項

安裝客戶端程式庫時將安裝以下程式庫：

• httplib2
• 烏裡模板

為了進行開發，您還需要以下程式庫：

• 網路測試
• pyopenssl

貢獻

請參閱我們的貢獻指南。我們特別喜歡拉取請求 - 但請確保簽署貢獻者許可協議。