会話メッセージを 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
メソッドを呼び出します。このメソッドは長時間実行オペレーションであるため、完了のステータスを確認する必要があります。