用語集

ネットワーク API

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

Google API

  • Google サービスによって公開されるネットワーク API。ほとんどは googleapis.com ドメインでホストされています。この用語には、クライアント ライブラリや SDK など、他の種類の API は含まれません。

    すべての Google API は共通の使用状況モデルを共有します。API コンシューマは、API プロデューサーによって管理される API サービスを消費します。これにより、ユーザーに Google API 全体でシンプルで一貫したエクスペリエンスを提供できます。

Google Cloud API

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

API インターフェース

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

API バージョン

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

API メソッド

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

API リクエスト

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

API サービス

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

    Google API では、API とサービスの概念は、API サービスの類義語として使用されます。Google Cloud Console の [API ライブラリ] に表示されます。

API サービス名

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

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

  • API サービスが実際の API リクエストを処理するために使用するネットワークアドレスを指す。1 つの API サービスに複数の API サービス エンドポイント(https://pubsub.googleapis.comhttps://content-pubsub.googleapis.com など)が存在することもあります。

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