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

# ソーシャル

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

`POST` /users/v1/social

## **説明**

2人のプレイヤー間のソーシャル関係の変更、またはあるプレイヤーが別のプレイヤーに対して行っている個別のアクション（例: ブロック）を報告します。この情報は、GGWP がプレイヤーの報告が独立した情報源から来ているかを評価し、集団的な攻撃やいじめの可能性のあるケースを特定し、特定の事案が評判に与える影響を調整するためなどに使用されます。

## **パラメータ**

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

* **action**: ソーシャル関係のアクション from `user_action_id` to `user_recipient_id`. 2人のユーザー間のステータスはそれに応じて更新されます。サポートされる値: `friend`, `unfriend`, `follow`, `unfollow`, `block`, または `unblock:`
  * `friend` → user\_action\_id と user\_recipient\_id の間に友達関係の双方向リンクを追加します。2人のユーザーの順序は関係ありません
  * `unfriend` → user\_action\_id と user\_recipient\_id の間の友達関係の双方向リンクを削除します。2人のユーザーの順序は関係ありません
  * `follow` → user\_action\_id から user\_recipient\_id へのフォローの一方向リンクを追加します
  * `unfollow` → user\_action\_id から user\_recipient\_id へのフォローの一方向リンクを削除します
  * `block` → user\_action\_id から user\_recipient\_id へのブロックの一方向リンクを追加します
  * `unblock` → user\_action\_id から user\_recipient\_id へのブロックの一方向リンクを削除します
* **user\_action\_id**: アクションを実行したユーザーの一意の識別子。
* **user\_recipient\_id:** アクションを受け取るユーザーの一意の識別子。
* **タイムスタンプ:** ステータスが更新された時刻（ *Y*YYY-MM-DD HH:MM:SS.SSS または YYYY-MM-DD HH:MM:SS 形式、UTC。空の場合は、代わりにサーバー側の UTC タイムスタンプが使用されます。
* サンプル呼び出し

  ```bash
  curl --request POST 'https://api.ggwp.com/users/v1/social' \
  --header 'x-api-key: api_key' \\
  --header 'Content-Type: application/json' \\
  --data-raw '{
    "action": "friend",
    "user_action_id": "<id1>",
    "user_recipient_id": "<id2>",
    "timestamp": "2022-01-25 09:44:00"
  }'
  ```

## **出力**

* 200 - 正常な操作

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

###

###

###