JSON、CSV、XMLファイルへのデータのエクスポート

Suite Growth、Professional、Enterprise、Enterprise Plus Professional、Enterpriseプラン

ファストパス：管理センター >「アカウント」>「ツール」>「レポート」

重要：ご利用のZendeskアカウントでデータエクスポートが有効になっている必要があります。このオプションを有効にするには、Zendeskカスタマーサポートにアカウントオーナーがお問い合わせください。

データのエクスポートが有効になると、データをJSON、CSV、またはXMLのファイルにエクスポートできます。エクスポートを実行するたびに、新しいデータが生成されます。同じ種類のデータ（チケット、組織、ユーザー）に対して複数のエクスポートを同時に実行することはできません。

メモ：エクスポートのプロセスは、リクエストされたエクスポートの日付範囲とアカウントのチケットアクティビティのレベルに応じて、数分から数時間かかることがあります。もし、特定のエクスポートの待機について懸念がある場合は、Zendeskカスタマーサポートに連絡してください。

データをエクスポートするには、管理者または権限のあるエージェントである必要があります。

この記事では、次のトピックについて説明します。

データのエクスポートの有効化と無効化
ダウンロード可能なファイルにデータをエクスポートする
エクスポートオプションの概要

データのエクスポートの有効化と無効化

Zendesk内のデータを保護するために、すべてのアカウントでデータエクスポート機能は自動的には有効にされません。この機能が使用してアクティブにできない場合は、Zendeskカスタマーサポートに連絡してください。

データエクスポートが有効になっている場合、指定されたメールドメインの管理者および権限のあるエージェントが、Zendeskからデータをエクスポートできます。アカウントオーナーのメールドメインがデフォルトで使用されますが、アカウントオーナーは、必要に応じてドメインを変更することもできます。

データエクスポートをZendeskで有効にするには

Zendeskカスタマーサポートにお問い合わせください。自分のZendesk Supportサブドメイン名を忘れずに記入してください。

データをエクスポートする管理者のメールドメインを変更するには

管理センターで、サイドバーにある「 アカウント」をクリックし、「ツール」>「レポート」を選択します。
必要に応じて、「エクスポート」タブをクリックしてデータエクスポートオプションを表示します。旧バージョンの一部のZendeskでは、エクスポートオプションが別のタブに表示されます。

メモ：データエクスポートを有効にするように当社にご連絡いただかない限り、エクスポートオプションは表示されません。
「承認済みメールドメイン」で、ドメインを変更します。
たとえば、「mycompany.com」のように入力します。

このフィールドに値を入力しない場合、指定したドメインの管理者および権限のあるエージェントのみがデータエクスポート機能を使用できるように制限することはできません。その場合には、Zendesk Supportの管理者または権限のあるエージェントであれば、メールドメインに関係なく、データをエクスポートできるようになります。ここに値を入力した場合、管理者および権限のあるエージェントがデータエクスポートオプションを使用するには、承認されたメールドメインを使用してサインインする必要があります。
「保存」をクリックします。

データのエクスポートを無効にするには

管理センターで、サイドバーにある「 アカウント」をクリックし、「ツール」>「レポート」を選択します。
必要に応じて、「エクスポート」タブをクリックしてデータエクスポートオプションを表示します。旧バージョンの一部のZendeskでは、エクスポートオプションが別のタブに表示されます。
「エクスポートを無効にする」をクリックします。
「OK」をクリックして確定します。

ダウンロード可能なファイルにデータをエクスポートする

JSON、CSV、またはXMLファイルにデータをエクスポートして、そのオプションを選択した時点のデータのスナップショットを取得できます。

ファイルを要求すると、バックグラウンドジョブが開始され、ジョブが完了するとメールで通知されます。その後、データレポートが含まれているzipファイルをダウンロードできます。ダウンロードリンクは、少なくとも3日間は有効です。

XMLファイルにデータをエクスポートすると、生成されるZIPファイルの形式はZIP32になりますが、JSONおよびCSVのエクスポートでは、4GBを超えるJSONおよびCSVのデータセットの圧縮効率を高めるためにZIP64のファイル形式が使用されます。詳しくは、「大量データのエクスポートに関する改善についてのお知らせ」をご覧ください。

エクスポートしたファイルには、Zendesk APIでアクセスできるデータと同じデータが含まれています。たとえば、Usersレポートのデータは、Zendesk REST API:Usersを使ってユーザーデータにアクセスするためにGETコマンドを使用した場合に返されるのと同じデータです。詳細については、以下のトピックを参照してください。

Zendesk REST API: Usersを使ってユーザーデータにアクセスするためにGETコマンドを使用した場合に返されるのと同じデータです。
Zendesk REST API:Tickets
Zendesk REST API:Incremental Exports

ダウンロード可能なファイルにデータをエクスポートするには

管理センターで、サイドバーにある「アカウント」をクリックし、「ツール」>「レポート」を選択します。
必要に応じて、「エクスポート」タブをクリックしてデータエクスポートオプションを表示します。旧バージョンの一部のZendeskでは、エクスポートオプションが別のタブに表示されます。

データエクスポートが有効になっているアカウントの管理者または権限のあるエージェントであるにもかかわらず、このオプションが表示されない場合は、メールドメインの制限が設定されていて、承認されたメールドメインからサインインしていない可能性があります。
エクスポートオプションを選択します。
- JSONエクスポートの場合は、エクスポートするデータの日付範囲とタイプを選択し、「エクスポート」をクリックします。
  20万件を超えるチケットを扱うアカウントでは、JSONエクスポートの使用をお勧めします。チケット数が100万件を超えるアカウントは、31日分の単位でJSON形式でダウンロードされます。
- CSVエクスポートまたはXMLエクスポートの場合は、それぞれのエクスポートオプションの隣にある「ファイルをリクエスト」をクリックします。
エクスポートオプションについて詳しくは、「エクスポートオプションの概要」を参照してください。
バックグラウンドジョブが開始され、ジョブが完了するとメールで通知されます。
メール通知内のリンクをクリックして、レポートが含まれているzipファイルをダウンロードします。
ダウンロードリンクは、少なくとも3日間は有効です。

メール通知を受け取っていない場合は、「完全なJSONエクスポート」、「CSVエクスポート」、「完全なXMLエクスポート」、または「ユーザーのXMLのエクスポート」の横にある「最新」をクリックして、生成された最新レポートをダウンロードできます。最新のレポートには、現在のアカウントデータではなく、最後にリクエストした時点でのアカウントデータが表示されます。詳細については、「ダウンロード可能なデータエクスポートファイル受信の遅延について」を参照してください。

エクスポートオプションの概要

次の各データレポートをリクエストしてダウンロードすることができます。

メモ：CSVおよびJSONエクスポートは、サンドボックスのアカウントでは使用できません。

完全なJSONエクスポート

全データをJSON形式のオブジェクトのリストにエクスポートします。JSONエクスポートを使用すると、チケット、ユーザー、および組織の情報など、Zendeskアカウントのほとんどのデータをエクスポートできます。チケット数が100万件を超えるアカウントは、31日単位でJSON形式でダウンロードされます。

ZendeskはデータをNDJSON（Newline Delimited JSON）形式でエクスポートします。この形式により、システムはファイル全体を一度に読み取るのではなく、JSONオブジェクトを一度に1つずつストリーミングできます。これは、非常に大きなエクスポートファイル（Zendeskエクスポートなど）など、従来のJSONビューでは持て余すような場合に便利です。

NDJSONの詳細について詳しくは、こちらをお読みください。

ストリーミングバージョンではなく、すべての情報を含む単一のJSONファイルが必要な場合は、オブジェクトを配列にラップし、各行をコンマで区切る必要があります。

例：Supportは次のオブジェクトをエクスポートしました。
```
{"ticket":{"id":....}}
{"ticket":{"id":....}}
{"ticket":{"id":....}}
```
有効なJSONファイルを作成するには、次のようにオブジェクトを配列にラップします。
```
{"tickets":[ 
{"ticket":{"id":....}}, 
{"ticket":{"id":....}}, 
{"ticket":{"id":....}}
]}
```
これらのエクスポートの日付範囲には、システム生成のタイムスタンプが使用されます。通常、これらのタイムスタンプは、チケット、ユーザー、または組織に記録された最新の更新日と一致します（作成日ではありません）。システムの更新でチケットイベントが発生しない場合があります。このような場合には、予期しないチケットが出力に表示されることがあります。
JSONエクスポートでは、チケットからエクスポートされるデータ量が1MB以上の場合、チケットのコメントがJSONファイルから除外されます。ダウンロード可能なZIPファイルには、以下の2つのJSONファイルが含まれます。
- エクスポートされたすべてのチケットを含むJSONファイル（1MBの制限を超えてコメントなしでエクスポートされたチケットも含む）。
- 1MBの制限を超えたチケットと、コメントが含まれていない理由が1MBの制限を超えたためであることを知らせるエラーメッセージを含むJSONファイル。以下はその例です。

CSVエクスポート

チケットデータをCSV形式でエクスポートします。削除されたチケット、チケットのコメント、またはチケットの説明は含まれません。

メモ：CSVエクスポートでは、すべての日付と時刻の値がアカウントのデフォルトのタイムゾーン（エクスポート時のタイムゾーン）に変換されます。CSVファイルに表示される日付は、ユーザーのタイムゾーンを表示するJSONエクスポート（UTC）の日付やExploreの日付と一致しない場合があります。アカウントのタイムゾーンの設定について詳しくは、「Zendesk Supportのタイムゾーンとフォーマットを設定する」を参照してください。

CSVエクスポートでは、チケットからエクスポートされるデータ量が1MB以上の場合、そのチケットはエクスポートされません。したがって、CSVファイルにも含まれません。ただし、このようなことは通常は起こりません。一般的にチケット内の最大のデータコンポーネントはコメントですが、CSVエクスポートにはコメントが含まれないからです。

CSVエクスポートに含まれるチケットデータについては、「CSVエクスポートに含まれるチケットデータについて」を参照してください。

完全なXMLエクスポート

データをXML形式でエクスポートします。ファイルには以下の情報が含まれます。

アカウント：アカウント関連のすべての設定
エントリ：フォーラムに追加されたすべてのコンテンツ（コメントを含む）です。これは、旧バージョンのZendeskの機能です。ほとんどのアカウントでは、データのエクスポートにはエントリが含まれません。
フォーラム：フォーラムの詳細情報。これは、旧バージョンのZendeskの機能です。ほとんどのアカウントでは、データのエクスポートにはフォーラムが含まれません。
グループ：所属しているグループに関する詳細情報
組織：所属している組織に関する詳細情報
チケット：すべてのチケットのすべての詳細情報（コメントも含む）
ユーザー：すべてのユーザー（エンドユーザー、エージェント、管理者）の一覧

メモ：20万件を超えるチケットを扱うアカウントでは、完全なXMLエクスポートは利用できません。完全なJSONエクスポートをご利用ください。

ユーザーのXMLエクスポート

ユーザーデータをXML形式でエクスポートします。ファイルには以下の情報が含まれます。

グループ：所属しているグループに関する詳細情報
組織：所属している組織に関する詳細情報
ユーザー：すべてのユーザー（エンドユーザー、エージェント、管理者）の一覧

重要：ユーザーまたは組織のデータをXMLレポート用にエクスポートすると、タグは含まれますが、カスタムユーザーフィールドおよびカスタム組織フィールドは含まれません。カスタムユーザーフィールドを取得するには、このAPIエンドポイントを使用します。カスタム組織フィールドを取得するには、このAPIエンドポイントを使用します。

CSVエクスポートに含まれるチケットデータについて

CSVエクスポート内のチケットデータには、以下の内容が含まれます。複数行テキストとマルチセレクトフィールド、カスタム日付フィールドはCSVエクスポートから除外されますが、完全なJSONエクスポートおよびXMLエクスポートには含めることができます。

データ	説明
ID	チケットの番号。
リクエスタ	リクエスタの名前。
リクエスタID	リクエスタのID番号。
リクエスタ外部ID	外部システムのID。JWTまたはSAMLを使用するProfessionalまたはEnterpriseシングルサインオンが有効になっているアカウント向けのオプションです。
リクエスタのメールアドレス	リクエスタのメインメールアドレス。ユーザーのセカンダリメールアドレスのリストをエクスポートしたい場合は、IDのサイドロード時にList Users APIエンドポイントを使用する必要があります（例：`GET /api/v2/users.json?include=identities`）。
リクエスタのドメイン	リクエスタのメインのメールアドレスのメールドメイン。
送信者	最初の送信者の名前。リクエスタがチケットの送信者である場合、リクエスタの名前が表示されます。エージェントがリクエスタの代理人としてチケットを送信した場合、エージェントの名前が表示されます。リクエスタが変わっても、この最初の送信者の名前は変わりません。
担当者	エクスポート時の担当者。
グループ	エクスポート時の担当者の所属グループ。
件名	チケットの件名。
タグ	エクスポート時にチケットに追加されていたタグ。
ステータス	エクスポート時のステータス。
優先度	エクスポート時の優先度。
経由	チケットの送信時に経由したチケットチャネル。
チケットタイプ	エクスポート時のチケットのタイプ。
作成日時	チケットの作成日時。アカウントのタイムゾーンで表示します。
更新日時	チケットが最後に更新された日時。アカウントのタイムゾーンで表示します。
割り当て日時	エージェントが最後に割り当てられた日時（現在の担当者に割り当てられた日時など）。アカウントのタイムゾーンで表示します。
組織	現在のリクエスタの組織（組織に所属している場合）。
期限	エクスポート時の期限。アカウントのタイムゾーンで表示します。
最初の割り当て日時	グループではなく、エージェントにチケットが初めて割り当てられた日時。アカウントのタイムゾーンで表示します。
解決日時	最後に解決済みステータスに変更された日時。アカウントのタイムゾーンで表示します。
解決時間	最終的に解決に要した時間（時間単位）。端数は整数に四捨五入されます。
満足度スコア	現在の満足度評価ステータス（Not Offered、Offered、Good、Bad）。
グループステーション	グループの割り当ての変更が行われた回数。チケット作成時に行われた割り当てもステーション数として計算に入れられます。
担当者ステーション	エージェントの割り当ての変更が行われた回数。チケット作成時に行われた割り当てもステーション数として計算に入れられます。
再オープン	エージェントまたはエンドユーザーがチケットのステータスを「解決済み」から「オープン」に変更した回数。
返信	エージェントやエンドユーザーからのコメントに対するエージェントによるチケット内のパブリック返信数。
初回返信時間（分）	チケット作成時刻から、最初のパブリックエージェントコメントのタイムスタンプまでに経過した時間。分単位で表示します。
営業時間内の初回の回答時間（分）	上の行と同じ。ただし、営業時間中の経過時間のみを計算に入れます。
初回解決時間（分）	チケット作成時刻から、チケットのステータスが初めて「解決済み」に変更された時点のタイムスタンプまでに経過した時間。分単位で表示します。
営業時間内の初回解決時間（分）	上の行と同じ。ただし、営業時間中の経過時間のみを計算に入れます。
全体解決時間（分）	分単位で表した、チケット作成時刻から、チケットのステータスが最後に「解決済み」に変更された時刻までに経過した時間
営業時間内の全体解決時間（分）	上の行と同じ。ただし、営業時間中の経過時間のみを計算に入れます。
エージェントの待機時間（分）	チケットが「保留中」ステータスにあった時間の合計。分単位で表示します。
営業時間内のエージェントの待機時間（分）	上の行と同じ。ただし、営業時間中の経過時間のみを計算に入れます。
リクエスタの待機時間（分）	新規およびオープンステータスの合計経過時間。チケットがいったん「解決済み」にされた後、再オープンされた場合は、「解決済み」ステータスにあった時間も計算に入れます。最終的に「解決済み」ステータスに変更された後の時間は計算に入れません。
営業時間内のリクエスタの待機時間（分）	上の行と同じ。ただし、営業時間中の経過時間のみを計算に入れます。
保留時間（分）	チケットが「待機中」ステータスにあった時間の合計。分単位で表示します。
営業時間内の保留時間（分）	上の行と同じ。ただし、営業時間中の経過時間のみを計算に入れます。