会話データをエクスポートする

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