> For the complete documentation index, see [llms.txt](https://docs.ggwp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ggwp.com/jp/apidokyumento-kontekisuto/pureiy.md).

# プレイヤー設定

\[ ベース URL: `api.ggwp.com`]

`POST` /data/v1/ingest

## **説明**

ゲームセッション中に選択された、毒性に対するプレイヤーの許容レベルを示すプレイヤー設定を報告します。これには、チャットの無効化、別のプレイヤーのミュート、フィルター感度の選択、カスタムブロックリストの作成などが含まれます。この情報は、インシデントに重大度の修正を適用したり、GGWPのモデレーションツールでインシデントやプレイヤーを確認する際に追加の文脈を提供したりするために使用されます。

## **パラメータ**

`ボディ`: 次のフィールドを含む辞書:

* **type**: `player-settings`
* **user\_id**：プレイヤーの一意の識別子。
* **session\_id**：セッションの一意の識別子。
* **action**: `chat-disable` / `player-mute` / `filter-sensitivity` / `custom-blocklist`
* **タイムスタンプ:** アクションが実行された時刻は *YYYY-MM-DD HH:MM:SS* 形式です。UTCで記録されます。空の場合は、代わりにサーバー側のUTCタイムスタンプが使用されます。
* **additional\_details**：実行されたアクションに関連する追加情報を含む辞書。例：
  * **target\_user\_id**：対象プレイヤーの一意の識別子（アクションが `player-mute`)
  * **filter\_settings**：選択されたフィルターレベル（アクションが `filter-sensitivity`)
  * **terms**：カスタムでブロックされた用語の一覧（アクションが `custom-blocklist`)
* サンプル呼び出し（player mute）

  ```bash
  curl --request POST 'https://api.ggwp.com/data/v1/ingest' \\
  --header 'x-api-key: api_key' \\
  --header 'Content-Type: application/json' \\
  --data-raw '{
    "type": "player-settings",
    "user_id": "<id1>",
    "session_id": "<sessionID1>",
    "action": "player-mute",
    "timestamp": "2022-01-25 09:44:00",
    "additional_details": {
      "target_user_id": "<id2>"
    }
  }'
  ```
* サンプル呼び出し（custom blocklist）&#x20;

  ```bash
  curl --request POST 'https://api.ggwp.com/data/v1/ingest' \\
  --header 'x-api-key: api_key' \\
  --header 'Content-Type: application/json' \\
  --data-raw '{
    "type": "player-settings",
    "user_id": "<id1>",
    "session_id": "<sessionID1>",
    "action": "custom-blocklist",
    "timestamp": "2022-01-25 09:44:00",
    "additional_details": {
      "terms": ["incel", "gey", "simp", "chad"]
    }
  }'
  ```

## **出力**

* 200 - 正常な操作

  ```json
  {
    "status": "success"
  }
  ```
* 400
  * エラーレスポンス。イベントはシステムに挿入されていません。このエラーは次のケースで発生します：
    * `無効な本文。JSON入力が必要です`
      * データペイロードはJSON形式ではありません
    * `データペイロードが大きすぎます`
      * データペイロードのサイズが1MBを超えています
* 403
  * 無効なAPIキー、またはAPIキーがありません。
* 500
  * エラーレスポンス。イベントはシステムに挿入されていません。リクエストの処理中にサーバー側でエラーが発生しました。