# プレイヤーエビデンスレポート API

> プレイヤーエビデンスレポート API を使用して、プレイヤーが参加した会話を取得します。

プレイヤーエビデンスレポート API は、任意の時間フィルターを使用して、ユーザーが参加した会話のリストを返します。

以下は、プレイヤーエビデンスのリクエストの例です。

```text
curl https://services.api.unity.com/vivox/text-evidence-management/v1/organizations/<organization_id>/projects/<project_id>/player-evidence-report?user_uri=sip:your-issuer.john.@yourvivoxdomainname.vivox.com -u service-acct-username:service-account-password
```

`user_uri` は必須で、該当するユーザーの SIP URI にマップされます。

プレイヤーエビデンスレポート API は、以下の任意のクエリパラメーターを受け入れます。

| パラメーター              | 説明                                                                                                                                                                                                      |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `start_ts`          | Unix タイムスタンプ。このタイムスタンプ以降にユーザーの最後のアクティビティがあった会話をフィルターします。                                                                                                                                                |
| `end_ts`            | Unix タイムスタンプ。このタイムスタンプ以前にユーザーの最後のアクティビティがあった会話をフィルターします。                                                                                                                                                |
| `num_conversations` | レスポンスで返す会話の数。                                                                                                                                                                                           |
| `request_start_ts`  | このパラメーターは、最初のページより後のページ処理リクエストで使用します。この値はレスポンスのペイロードで返されます。レスポンスでは会話がプレイヤーの最新のアクティビティの順で表示され、レスポンス内の next 値は、次に取得する会話内のプレイヤーの最新のアクティビティを表します。`request_start_ts` パラメーターは、ユーザーが現在チャット中である場合にページの正確性を保ちます。 |