googleapisダウンロード - googleapisソースコードのダウンロード

googleapis

その他のソースコード

1.0.0

ダウンロード

Google API

このリポジトリには、REST プロトコルと gRPC プロトコルの両方をサポートするパブリック Google API の元のインターフェイス定義が含まれています。元のインターフェース定義を読むと、Google API をより深く理解し、より効率的に利用できるようになります。これらの定義をオープンソースツールで使用して、クライアントライブラリ、ドキュメント、その他の成果物を生成することもできます。

建物

バゼル

API クライアントライブラリを構築する推奨方法は、Bazel 以降 4.2.2 を使用することです。

まずはベゼルを取り付けます。

すべてのライブラリをビルドするには:

 bazel build //...

すべてのライブラリをテストするには:

 bazel test //...

すべての言語で 1 つのライブラリを構築するには:

 bazel build //google/example/library/v1/...

1 つのライブラリの Java パッケージをビルドするには:

 bazel build //google/example/library/v1:google-cloud-example-library-v1-java

Bazel パッケージは、Java、Go、Python、Ruby、Node.js、PHP、および C# のすべてのライブラリに存在します。

概要

Google API は通常、異なる DNS 名でホストされる API サービスとしてデプロイされます。 1 つの API サービスが複数の API および同じ API の複数のバージョンを実装する場合があります。

Google API は、プロトコルバッファーバージョン 3 (proto3) をインターフェイス定義言語 (IDL) として使用して、API インターフェイスとペイロードメッセージの構造を定義します。 API の REST バージョンと RPC バージョンの両方に同じインターフェイス定義が使用され、異なるワイヤプロトコル経由でアクセスできます。

Google API にアクセスするには、いくつかの方法があります。

JSON over HTTP: Google API クライアントライブラリまたはサードパーティ API クライアントライブラリを使用して、JSON over HTTP を使用してすべての Google API に直接アクセスできます。
gRPC 上のプロトコルバッファ: このリポジトリで公開されている Google API には、HTTP/2 上の高性能バイナリ RPC プロトコルである GRPC を通じてアクセスできます。リクエスト/レスポンス多重化や全二重ストリーミングなど、多くの便利な機能を提供します。
Google Cloud クライアントライブラリ: これらのライブラリを使用して、Google Cloud API にアクセスできます。これらはパフォーマンスを向上させるために gRPC に基づいており、開発者エクスペリエンスを向上させるための慣用的なクライアントサーフェスを提供します。

ディスカッション

このリポジトリには、Google API 定義と関連ファイルのコピーが含まれています。 Google API クライアントライブラリ、GRPC、または Google Cloud クライアントライブラリに関するディスカッションや問題提起については、各領域に関連付けられたリポジトリを参照してください。

リポジトリ構造

このリポジトリは、Google API 製品構造を反映したディレクトリ階層を使用します。一般に、すべての API には独自のルートディレクトリがあり、API の各メジャーバージョンには独自のサブディレクトリがあります。プロトパッケージ名はディレクトリと正確に一致します。これにより、プロト定義を簡単に見つけることができ、生成されたクライアントライブラリがほとんどのプログラミング言語で慣用的な名前空間を持つことが保証されます。 API ディレクトリと並んで、GAPIC ツールキットの構成ファイルも存在します。

注: API のメジャーバージョンは、API への重大な変更を示すために使用されます。

gRPC ソースコードの生成

このリポジトリで Google API の gRPC ソースコードを生成するには、まずプロトコルバッファーと gRPC の両方をローカルマシンにインストールする必要があります。その後、 make LANGUAGE=xxx all実行してソースコードを生成できます。生成されたソースコードをアプリケーションビルドシステムに統合する必要があります。

注: Makefile は、リポジトリ全体のソースコードを生成することのみを目的としています。特定の API 用のリンク可能なクライアントライブラリを生成するためのものではありません。リンク可能なクライアントライブラリを生成するには、https://github.com/googleapis にある他のリポジトリを参照してください。