複数のプロジェクトの使用

場合によっては、Dialogflow を使用するには、複数の Google Cloud プロジェクトを作成する必要があります。

コンシューマプロジェクトとリソースプロジェクト

API を呼び出すときは、通常、認証用のサービスアカウントキーを指定します。各サービスアカウントは特定のプロジェクトが所有していますが、サービスアカウントは他のプロジェクトのリソースにアクセスする役割を与えられる可能性があります。API 呼び出しに指定したサービスアカウントに関連付けられたプロジェクトは、コンシューマプロジェクトと呼ばれます。

API に呼び出しを行うと、リクエストでエージェントのプロジェクトが指定されます。このプロジェクトはリソースプロジェクトと呼ばれます。

たとえば、次の REST curl リクエストでは、AGENT_ID に関連付けられたプロジェクトはリソースプロジェクトであり、TOKEN の生成に使用されるサービスアカウントに関連付けられたプロジェクトはコンシューマプロジェクトです。

curl -X GET
    -H "Authorization: Bearer TOKEN"
    "https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/agent/AGENT_ID"

1 つのプロジェクトが、コンシューマプロジェクトとリソースプロジェクトの両方の役割を兼ねることができます。エージェントのデータ、料金、割り当ては、このプロジェクトにのみ関連付けられます。

コンシューマプロジェクトとリソースプロジェクトが 2 つの異なるプロジェクトの場合、API を有効にするための要件、料金、割り当ての制約、エージェント情報が、プロジェクトのいずれかまたは両方に適用されます。次の表に、2 つのプロジェクトによる API 呼び出しの関連付けを示します。

説明	ユーザープロジェクト（サービスアカウントプロジェクト）	リソースプロジェクト（エージェントプロジェクト）	メモ
料金が発生するプロジェクト	✔
割り当てにバインドされているプロジェクト	✔
体験版または Essentials Dialogflow のエディションを決定するエージェントを含むプロジェクト	✔		ユーザープロジェクトにエージェントがない場合は、空白のエージェントを作成して Essentials エディションにアップグレードします。
すべてのエージェントデータと体験版または Essentials Dialogflow エディションを含むプロジェクト		✔
Dialogflow API を有効にする必要があるプロジェクト	✔	✔	Dialogflow API は、両方のプロジェクトタイプで有効にする必要があります。
Cloud コンソールの API ダッシュボードに API の使用状況が表示されるプロジェクト	✔