> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /titles/{titleId}/recentplayers

> Post Recent Players

# Post Recent Players

ユーザーの最近のプレイヤー リストに追加または更新します (単方向)。

この API により、ゲーム クライアントはユーザーの最近のプレイヤー リストに追加したり、既存の最近のプレイヤー エントリを更新したりできます。この呼び出しは呼び出し元の最近のプレイヤー リストにのみ影響します (単方向)。

```http theme={null}
POST /titles/{titleId}/recentplayers
```

## URI パラメーター

| Parameter | In | Required | Type | Description |
| - | - | - | - | - |
| titleId | path | TRUE | integer | リクエストの送信対象となるゲームの titleId。 |

## リクエスト ヘッダー

| Name | Required | Type | Description |
| - | - | - | - |
| Authorization | TRUE | integer | 呼び出し元は XBL 3.0 認証形式で XToken を指定する必要があります。例: Authorization: XBL3.0 x=2553948354698;>encrypted token\<) |
| Content-Type | TRUE | string | ContentType は application/json に設定する必要があります |

## リクエスト本文

| Name | Required | Type | Description |
| - | - | - | - |
| recentPlayers | TRUE | | このユーザーの最近のプレイヤーの配列。最近のプレイヤーは少なくとも 1 人、最大 100 人まで指定する必要があります。 |

## レスポンス

| Name | Type | Description |
| - | - | - |
| 204 No Content | | 最近のプレイヤー リクエストが正常に送信されました。 |
| 400 Bad Request | [ErrorResponse](#errorresponse) | リクエストの処理中にエラーが発生しました。考えられるエラー コード: "RequestValidationError: The request validation has failed.", " AuthorizationError: The caller is not allowed to access the resource." |
| Other Status Codes | [ThrottledEntity](#throttledentity) | リクエストが多すぎます。Headers Retry-After: integer |

## 定義

* [ClientRecentPlayersRequest](#clientrecentplayersrequest)
* [EncounterType](#encountertype)
* [ErrorResponse](#errorresponse)
* [Network](#network)
* [ThrottledEntity](#throttledentity)

### ClientRecentPlayersRequest

| Name | Type | Description |
| - | - | - |
| recentPlayers | | このユーザーの最近のプレイヤーの配列。最近のプレイヤーは少なくとも 1 人、最大 100 人まで指定する必要があります。 |

### EncounterType

最近のプレイヤーとの出会いの種類。このフィールドはオプションで、既定値は Default です。Default には規定された意味はありません。呼び出し元がこの値を適切に解釈します。

| Name | Type | Description |
| - | - | - |
| Default | string | |
| Opponent | string | |
| Teammate | string | |

### ErrorResponse

| Name | Type | Description |
| - | - | - |
| debugMessage | string | デバッグに使用できる、人間が読めるエラー メッセージ。 |
| errorCode | string | エラー コード列挙型。 |

### Network

| Name | Type | Description |
| - | - | - |
| XboxLive | string | |

### ThrottledEntity

| Name | Type | Description |
| - | - | - |
| currentRequests | string | 現在のリクエスト数 - 同時実行数またはレート。 |
| debugMessage | string | デバッグに使用できる、人間が読めるスロットル メッセージ。 |
| limitType | string | 制限の種類 (例: 同時実行またはレート)。 |
| maxRequests | string | 許可される最大リクエスト数 - 同時実行数またはレート。 |
| periodInSeconds | string | レートまたは同時実行の制限を超えた場合に適用される秒単位の期間。 |
| version | string | 現在のスロットル契約バージョン。 |


## Related topics

- [POST /titles/{titleId}/recentplayers/server](https://docs.xbox.com/ja-jp/reference/live/rest/uri/multiplayeractivity/swagger-uris/uri-PostServerUniRecentPlayers.md)
- [POST /titles/{titleId}/recentplayergroups/server](https://docs.xbox.com/ja-jp/reference/live/rest/uri/multiplayeractivity/swagger-uris/uri-PostServerRecentPlayerGroup.md)
- [POST /titles/{titleId}/invites](https://docs.xbox.com/ja-jp/reference/live/rest/uri/multiplayeractivity/swagger-uris/uri-SendInvite.md)
- [POST /titles/{titleId}/activities/query](https://docs.xbox.com/ja-jp/reference/live/rest/uri/multiplayeractivity/swagger-uris/uri-ExternalGetActivityBatch.md)
- [POST /titles/{titleId}/invites/server API](https://docs.xbox.com/ja-jp/reference/live/rest/uri/multiplayeractivity/swagger-uris/uri-SendServerInvite.md)