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

# プレイヤーアクティビティ: バッチ

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

`POST` /users/v1/activity-bulk 

## **説明**

CSVファイルからユーザーのアクティビティを記録するためのAPIです。CSVファイルに記載されたすべてのユーザーのログイン／ログアウト時刻を記録します

CSVファイルは、タイムスタンプをUTCで以下のテンプレートに従う必要があります

```csv
user_id,login_time,logout_time,username
0000499b-ea03-4517-a6d8-630831daba7a,2025-12-30 07:44:37,2025-12-30 07:54:37,username-abc
```

例の画像は以下です：

<figure><img src="/files/55c55703d4c38d9eeb40d2e6cc2c8f821c0fd9a8" alt=""><figcaption></figcaption></figure>

## **重要事項**

* 入力ファイルはCSVファイルである必要があります
* 入力ファイルサイズは4 MBを超えてはいけません

## **パラメータ**

`ボディ`:

* CSVファイル
* サンプル呼び出し

  ```bash
  curl --location --request POST 'https://api.ggwp.com/users/v1/activity-bulk' \
  --header 'x-api-key: api_key' \\
  --header 'Content-Type: text/csv' \
  --data-binary 'File/path/user-activity-data.csv'
  ```

## **出力**

* 200 - 正常な操作

  ```json
  {
     「正常にアップロードされました」
  }
  ```
* 400 - 不正なリクエスト
  * エラーレスポンス。ユーザーのアクティビティはシステムに記録されていません。このエラーは、渡された値が
    * 4 MB超過
    * CSV形式ではないファイル
* 403
  * 無効な API キー、または API キーがありません
* 500
  * エラーレスポンス。ユーザーのアクティビティはシステムに記録されていません。リクエストの処理中にサーバー側で何らかのエラーが発生しました