リージョン指定とデータ所在地

Dialogflow では、データ所在地を提供することで保存データを地理的リージョンまたはロケーションに物理的に保持します。リージョンを指定すると、保存データはリージョン外で複製されません。料金はすべてのリージョンで同一です。

リージョンは次の理由で使用されます。

システムに、データの保管場所を制御する規制要件またはポリシー要件が含まれる場合があるため。
お客様と同じリージョンにデータが存在する場合、ネットワークのレイテンシが改善されることがあるため。たとえば、英国のお客様が europe-west2 を使用すると、レイテンシの改善が期待できます。

保存データ

すべての Dialogflow デベロッパーユーザーデータとエンドユーザーデータは、保存データに含まれています。次に例を示します。

コンソールまたは API で設定されたすべてのエージェントリソース（インテント、エンティティなど）
コンソールまたは API で設定されたすべてのエージェント設定
クエリ履歴
検証結果
モデル作成タスク
トレーニングタスク
長時間実行オペレーションタスク

利用可能なリージョン

Dialogflow では次のリージョンが利用できます。

国のグルーピング	地理的位置	リージョン ID
ヨーロッパ	ベルギー	`europe-west1`
ヨーロッパ	ロンドン	`europe-west2`
アジア太平洋	シドニー	`australia-southeast1`
アジア太平洋	東京	`asia-northeast1`
グローバル	Dialogflow の提供はグローバル、保存データは米国内に格納	`global`（推奨）、またはリージョンなし（デフォルト）*

記号	説明
*	`global` リージョンへの呼び出しは、米国外から呼び出す際にレイテンシが大きくなる可能性があります。可能であれば、サービスとエンドユーザーにもっと近いリージョンを選択してください。

コンソールでリージョンを選択する

Dialogflow ES コンソールの左上部分には、リージョンの選択のプルダウンがあります。すべてのエージェントには、作成時に指定された変更できないリージョンが含まれます。コンソールからリージョンを選択すると、選択したリージョンのエージェントのみを一覧表示または作成できます。デフォルトのリージョンは global です。

API を使用してリージョンを選択する

デフォルト以外のリージョンにエージェントが作成された場合は、設計時のリクエストかランタイムリクエストのために API を呼び出すときに、そのリージョンを指定する必要があります。

リージョンを指定するには、API リクエストに location パラメータを指定します。REST 呼び出しの場合は、次の両方を行います。

location URL パスパラメータを指定します。 global マルチリージョンの場合は、global を使用します。
global マルチリージョンの場合は、ホスト名に dialogflow.googleapis.com を使用します。他のリージョンではすべてホスト名に [REGION_ID]-dialogflow.googleapis.com を使用します。

例:

https://dialogflow.googleapis.com/v2/projects/PROJECT/locations/global/agents/
https://asia-northeast1-dialogflow.googleapis.com/v2/projects/PROJECT/locations/asia-northeast1/agents/

クライアントライブラリについては、クライアントライブラリのドキュメントをご覧ください。次の操作を行う必要があります。

Dialogflow サービスエンドポイントを次のいずれかに設定します。
```
dialogflow.googleapis.com:443
REGION_ID-dialogflow.googleapis.com:443
```

セッション名を設定:

projects/PROJECT_ID/locations/REGION_ID/agent/sessions/SESSION_ID

注意: 設定ドキュメントで説明されているように、クライアントライブラリに認証情報を提供するには GOOGLE_APPLICATION_CREDENTIALS 環境変数を使用する必要があります。ただし、コード内に認証情報ファイルを手動で提供する必要がある場合は、リージョン化されたエンドポイントを呼び出す際に追加の手順を行う必要があります。認証情報の生成時にスコープを https://www.googleapis.com/auth/cloud-platform に設定します。たとえば、これは Java で GoogleCredentials オブジェクトを作成するときに行われます。

GoogleCredentials.fromStream(new FileInputStream("credential_file"))
  .createScoped("https://www.googleapis.com/auth/cloud-platform")

Cloud のロギング

ログを保存するリージョンを指定する場合は、Cloud ロギングガイドをご覧ください。

制限事項

Dialogflow コンソールでデフォルト以外のリージョンが選択されている場合、次の機能は使用できません。

多くの REST リファレンスドキュメントにある APIs Explorer は、API 呼び出しの global リージョンのみをサポートしています。

長時間実行オペレーション

移行する