> 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/pureiyno.md).

# プレイヤーの支出

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

`POST` /users/v1/player-spend

## **説明**

個々のプレイヤーがゲーム内購入に費やした実際の通貨額を報告します。この情報は、GGWPのモデレーションワークフローパネルで追加のコンテキストを提供するために使用され、コミュニティマネージャーやモデレーションチームがプレイヤーの行動を評価する際に最善の判断を下せるようにします。

## **パラメータ**

`body`: 以下のフィールドを含む辞書:

* **user\_id**: プレイヤーの一意の識別子。
* **(任意) platform:** 購入が発生した場所（例: Xbox、PlayStation、Android など）
* **currency**: 使用された通貨の種類（例: “USD”, “EUR”, “JPY”, “BTC” など）
* **transaction\_amount**: 完了した取引の数値。
* **item\_category**: `game_purchase` / `battlepass` / `cosmetic`.
* **item\_id**: 購入したアイテムの種類を示す識別子。
* **(任意)lifetime\_spend**: プレイヤーの生涯にわたって費やした累計金額。
* **(任意) timestamp:** 取引が実行された時刻を *YYYY-MM-DD HH:MM:SS* UTC形式で示します。空白の場合は、サーバー側のUTCタイムスタンプが代わりに使用されます。
* サンプル呼び出し

  ```bash
  curl --request POST 'https://api.ggwp.com/users/v1/player-spend' \\
  --header 'x-api-key: api_key' \\
  --header 'Content-Type: application/json' \\
  --data-raw '{
    "user_id": "<id1>",
    "platform": "android",
    "currency": "USD",
    "transaction_amount": 6.50,
    "item_category": "cosmetic",
    "item_id": "skin",
    "lifetime_spend": 124.75,
    "timestamp": "2022-01-25 09:44:00"
  }'
  ```

## **出力**

* 200 - 正常な操作

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