用語集

Network API

  • コンピュータのネットワーク上で動作するアプリケーション プログラミング インターフェース。HTTP、gRPC などのネットワーク プロトコルを使用して通信し、多くの場合、使用する組織とは異なる組織によって生成されます。

Google API

  • Google サービスによって公開される Network API。ほとんどは googleapis.com ドメインでホストされています。Google Cloud ConsoleService Usage API を使用して、利用可能な Google API ご覧いただけます。この用語には、クライアント ライブラリや SDK など、他の種類の API は含まれません。

Google Cloud API

  • Google Cloud サービスによって公開される Google API のサブセット。詳しくは Google Cloud APIs をご覧ください。

API インターフェース

  • プロトコル バッファの service 定義。通常、ほとんどのプログラミング言語のインターフェースにマップされます。API インターフェースは任意の数の API サービスで実装できます。

API バージョン

  • API インターフェース、または一緒に定義されている場合は API インターフェースのグループのバージョン。API バージョンは、多くの場合「v1」などの文字列で表され、API リクエストやプロトコル バッファのパッケージ名に含まれます。

API メソッド

  • API インターフェース内の個々のオペレーション。これは、プロトコル バッファで rpc 定義によって表され、通常はほとんどのプログラミング言語でインターフェースの関数にマッピングされます。

API リクエスト

  • API メソッドの 1 回の呼び出し。多くの場合、請求、ロギング、モニタリング、レート制限の単位として使用されます。

API サービス

  • Cloud Pub/Sub API など、1 つ以上のネットワーク アドレスで公開される、1 つ以上の API インターフェースのデプロイされた実装。

API タイトル

  • 「Cloud Pub/Sub API」などの API サービスのユーザー向けプロダクト タイトルを指します。

API サービス名

  • API サービスの論理識別子を指す。Google API では、「pubsub.googleapis.com」などの API サービス名として、RFC 1035 DNS 互換名を使用します。

API サービス エンドポイント

  • API サービスが実際の API リクエストを処理するために使用するネットワークアドレスを指す。例: https://pubsub.googleapis.comhttps://content-pubsub.googleapis.com。1 つのサービスに複数のエンドポイントを配置できます

API サービス定義

  • API サービスを定義するために使用される API インターフェース定義(.proto ファイル)と API サービス構成(.yaml ファイル)の組み合わせ。 Google API サービス定義のスキーマは、google.api.Service です。

API プロダクト

  • API サービスと、利用規約、ドキュメント、クライアント ライブラリ、サービス サポートなどの関連コンポーネントは、プロダクトとして集合的に顧客に提供されます。たとえば、Google Calendar API などです。API 製品は単に API と呼ばれることがあります。

API コンシューマ

  • API サービスを使用するエンティティ。Google API の場合、通常はクライアント アプリケーションまたはサーバー リソースを所有する Google プロジェクトです。

API プロデューサー

  • API サービスを生成するエンティティ。Google API の場合、通常は API サービスを所有する Google プロジェクトです。

API バックエンド

  • API サービスのビジネス ロジックを実装する一連のサーバーと関連インフラストラクチャ。個々の API バックエンド サーバーは、一般的に API サーバーと呼ばれます。

API フロントエンド

  • 負荷分散や認証など、API サービス全体に共通の機能を提供する一連のサーバーと関連インフラストラクチャ。個々の API フロントエンド サーバーは、一般的に API プロキシと呼ばれます。

    API フロントエンドと API バックエンドは、互いに隣り合っていても、互いに離れていても実行することができます。場合によっては、単一のアプリケーション バイナリにコンパイルして、単一のプロセス内で実行することもできます。