google api python client

Google APIクライアント

これは、Google のディスカバリー ベースの API 用の Google API Python クライアント ライブラリです。開始するには、docs フォルダーを参照してください。

このライブラリは完成したとみなされ、メンテナンス モードになっています。これは、重大なバグやセキュリティ問題には対処しますが、新しい機能は追加しないことを意味します。

このライブラリは Google によって正式にサポートされています。ただし、このリポジトリの管理者は、新しいコードの開発には、可能であれば Python 用の Cloud クライアント ライブラリを使用することを推奨しています。詳細については、「クライアント ライブラリの説明」を参照してください。

バージョン2.0リリース

google-api-python-clientの 2.0 リリースでは、ディスカバリ ドキュメントが動的にフェッチされるのではなくライブラリにキャッシュされるようになったため、1.x と比較して大幅な信頼性の向上が含まれています。 v1.x から v2.x にアップグレードすることを強くお勧めします。

Python 3.7 以降のみがサポートされています。 Python をアップグレードできない場合は、v1 で Python 2.7 以降のサポートを継続するため、バージョン 1.x を引き続き使用してください。

Discovery ドキュメントは、 discovery.build()を呼び出したときに動的に取得されなくなります。代わりに、検出ドキュメントはクライアント ライブラリから直接取得されます。このライブラリの新しいバージョンは毎週リリースされます。検出ドキュメントをキャッシュした結果、このパッケージのサイズは前のバージョンと比較して少なくとも 50 MB 大きくなります。

詳細については、移行ガイドを参照してください。

ドキュメント

詳しい手順と追加のドキュメントについては、docs フォルダーを参照してください。

その他の Google API ライブラリ

このリポジトリの管理者は、次の理由により、新しいコードの開発には、可能であれば Python 用の Cloud クライアント ライブラリを使用することを推奨しています。

Python 用のクラウド クライアント ライブラリを使用すると:

• API ごとに個別のクライアント ライブラリがあるため、ダウンロードするクライアント ライブラリを選択できます。一方、 google-api-python-clientすべての API に対応する単一のクライアント ライブラリです。その結果、 google-api-python-clientの合計パッケージ サイズは 50MB を超えます。
• 各クライアント ライブラリは特定の API に重点を置いているため、基礎となる API に対する重大な変更に対してはより厳格な制御が行われます。
• これらのクラウド クライアント ライブラリには、各ライブラリが特定の API に焦点を当てているため、より多くの機能があり、場合によっては、ライブラリはその API を専門とするチームによって所有されています。
• 開発者はインテリセンスの恩恵を受けるでしょう。

詳細については、「クライアント ライブラリの説明」を参照してください。

Python 用の Cloud クライアント ライブラリへの移行には多くの利点がありますが、管理者はgoogle-api-python-client引き続きサポートされることを強調したいと考えています。

Google 広告 API の場合は、Python 用 Google 広告 API クライアント ライブラリを使用することをお勧めします。

Google Firebase Admin API の場合は、Firebase Admin Python SDK を使用することをお勧めします。

インストール

pip を使用して、このライブラリを virtualenv にインストールします。 virtualenv は、分離された Python 環境を作成するツールです。これが対処する基本的な問題は、依存関係とバージョン、および間接的なアクセス許可の 1 つです。

virtualenv を使用すると、システムのインストール権限を必要とせず、インストールされているシステムの依存関係と衝突することなく、このライブラリをインストールできます。

Mac/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

貢献する

貢献ガイドをご覧ください。特に、私たちはプル リクエストが大好きですが、必ずコントリビューター ライセンス契約に署名してください。