会話メッセージを Cloud Storage バケットにエクスポートできます。各会話は、標準の会話データ形式で個別の JSON ファイルとしてエクスポートされます。一度にエクスポートできる会話は最大 10,000 件で、各会話には最大 1, 000 件のメッセージを含めることができます。
認証とアクセス制御
会話をエクスポートするリクエストを送信する場合は、 エンドユーザーの認証情報を使用して認証を行います。 ユーザー アカウントには、Dialogflow API の読み取り ロールと、データをエクスポートする Cloud Storage バケットの編集 ロール(オブジェクトを上書きする権限を含む)が付与されている必要があります。ユーザー アカウントのロールの詳細については、Cloud Storage のアクセス制御と Dialogflow のアクセス制御のドキュメントをご覧ください。
コマンドラインで REST リクエストを実行する場合:
gcloud auth loginを使用して、ユーザー アカウントでgcloudを認証します。gcloud auth print-access-tokenを使用して、リクエスト認証用のトークンを作成します。
エクスポート可能な会話
エクスポートできるのは、 完了した会話のみです。 古い会話はシステムによって定期的に削除されるため、古い会話を参照しようとしても利用できない場合があります。
エクスポートのリクエスト
エクスポートをリクエストするには、
exportMessages
メソッドを呼び出します。このメソッドは
長時間実行オペレーションであるため、
完了のステータスを確認する必要があります。