このプロジェクトについて

このリポジトリは、Google Discovery ServiceのJSON記述ファイルから生成された、Google API向けの自動生成Goクライアントライブラリを提供します。各APIは個別にインポート可能なパッケージとして公開されているため、必要なものだけを取り込めます。例えば google.golang.org/api/tasks/v1 や google.golang.org/api/urlshortener/v1 をインポートし、NewService(ctx) でサービスを構築できます。 主な特徴: - 生成コード: ライブラリはDiscoveryドキュメントからジェネレータによって生成されるため、リリース間で破壊的変更を含む可能性があります。ジェネレータとその出力はベータ扱いです。 - サポート状況: Googleによる公式サポートですが、ライブラリは完成済みかつメンテナンスモードと説明されており、重大なバグやセキュリティ問題には対応しますが、新機能は追加されません。 - クラウドAPI: DatastoreやPub/SubなどGoogle Cloud Platformのサービスについては、READMEは別のCloud Client Libraries for Goを参照するよう案内しています。 認証: - デフォルトでは、サービスはGoogle Application Default Credentialsを使用するため、多くの環境で明示的な設定なしにアプリケーションを実行できます。 - JSONキーファイルは、明示的な認証情報タイプ(例: ServiceAccount)を指定して option.WithAuthCredentialsFile で、またはJSON認証情報を直接 option.WithAuthCredentialsJSON で指定できます。 - 旧来の option.WithCredentialsFile および option.WithCredentialsJSON 関数は、潜在的なセキュリティリスクのため非推奨です。 - より細かい制御が必要な場合は、golang.org/x/oauth2 の oauth2.TokenSource を option.WithTokenSource で渡せます。 ドキュメントと例: - より長いチュートリアルと使用例については、Getting Startedガイドとexamplesディレクトリが参照されています。 - パッケージドキュメントはpkg.go.devで利用可能で、コミュニティサポートはgolang-nutsメーリングリストが案内されています。 これはエンドユーザー向けアプリケーションではなく開発者向けSDKコレクションであり、その価値は、一貫した認証パターンで幅広いGoogle APIへの型付きアクセスをGoプログラムに提供することにあります。