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

# POST /titles/{titleId}/recentplayergroups/server

> Post Server Recent Player Group

# Post Server Recent Player Group

グループ内のすべてのユーザーの最近のプレーヤーに追加または更新します (双方向)。

この API を使用すると、ゲーム サーバーは複数のユーザーの最近のプレーヤー リストに追加し、既存の最近のプレーヤー エントリを更新できます。グループ内のすべてのユーザーは互いに最近のプレーヤー リストに追加されます (双方向)。

最近のプレーヤー グループの例: \[ \[A,B,C], \[A,D], \[E,F] ]。

A は B、C、および D と会いました。B は A および C と会いました。D は A のみと会いました。以下同様。

```http theme={null}
POST /titles/{titleId}/recentplayergroups/server
```

## URI パラメーター

| パラメーター | 場所 | 必須 | 種類 | 説明 |
| - | - | - | - | - |
| titleId | path | TRUE | integer | リクエストが送信されているゲームの titleId。 |

## リクエスト ヘッダー

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

## リクエスト本文

| 名前 | 必須 | 種類 | 説明 |
| - | - | - | - |
| recentPlayerGroups | TRUE | [RecentPlayerGroup](#recentplayergroup)\[] | 双方向の最近のプレーヤー グループの配列。少なくとも 1 つのグループ、最大 20 グループを指定する必要があります。各グループには少なくとも 2 人、最大 100 人のプレーヤーが含まれている必要があります。 |

## 応答

| 名前 | 種類 | 説明 |
| - | - | - |
| 204 No Content | | 最近のプレーヤー リクエストが正常に送信されました。 |
| 400 Bad Request | [ErrorResponse](#errorresponse) | リクエスト処理中にエラーが発生しました。可能なエラー コード: "RequestValidationError: The request validation has failed.", " AuthorizationError: The caller is not allowed to access the resource." |
| その他のステータス コード | [ThrottledEntity](#throttledentity) | リクエストが多すぎます。ヘッダー Retry-After: integer |

## 定義

* [BidirectionalRecentPlayer](#bidirectionalrecentplayer)
* [EncounterType](#encountertype)
* [ErrorResponse](#errorresponse)
* [Network](#network)
* [RecentPlayerGroup](#recentplayergroup)
* [ServerRecentPlayerGroupsRequest](#serverrecentplayergroupsrequest)
* [ThrottledEntity](#throttledentity)

### BidirectionalRecentPlayer

| 名前 | 種類 | 説明 |
| - | - | - |
| id | string | 別のユーザーの Id (基数 10 の整数の XUID)。 |
| network | [Network](#network) | 相手ユーザーと会ったネットワーク。 |

### EncounterType

最近のプレーヤーとの遭遇の種類。このフィールドは省略可能で、既定値は Default です。Default には所定の意味はありません。呼び出し元がこの値を適切に解釈する必要があります。

| 名前 | 種類 | 説明 |
| - | - | - |
| Default | string | |
| Opponent | string | |
| Teammate | string | |

### ErrorResponse

| 名前 | 種類 | 説明 |
| - | - | - |
| debugMessage | string | デバッグに使用できる、人間が読めるエラー メッセージのバージョン。 |
| errorCode | string | エラー コード列挙型。 |

### Network

| 名前 | 種類 | 説明 |
| - | - | - |
| XboxLive | string | |

### RecentPlayerGroup

グループ内のすべてのユーザーは、指定された時刻に互いに遭遇しています。各グループには少なくとも 2 人、最大 100 人のユーザーが含まれている必要があります。

| 名前 | 種類 | 説明 |
| - | - | - |
| encounterType | [EncounterType](#encountertype) | 最近のプレーヤーとの遭遇の種類。このフィールドは省略可能で、既定値は Default です。Default には所定の意味はありません。呼び出し元がこの値を適切に解釈する必要があります。 |
| recentPlayers | [BidirectionalRecentPlayer](#bidirectionalrecentplayer)\[] | |
| timestamp | string | |

### ServerRecentPlayerGroupsRequest

グループ内のすべてのユーザーは、指定された時刻に互いに遭遇しています。各グループには少なくとも 2 人、最大 100 人のユーザーが含まれている必要があります。

| 名前 | 種類 | 説明 |
| - | - | - |
| recentPlayerGroups | [RecentPlayerGroup](#recentplayergroup) | 双方向の最近のプレーヤー グループの配列。少なくとも 1 つのグループ、最大 20 グループを指定する必要があります。各グループには少なくとも 2 人、最大 100 人のプレーヤーが含まれている必要があります。 |

### ThrottledEntity

| 名前 | 種類 | 説明 |
| - | - | - |
| currentRequests | string | 現在のリクエスト数 - 同時実行またはレート。 |
| debugMessage | string | デバッグに使用できる、人間が読めるスロットル メッセージのバージョン。 |
| limitType | string | 制限の種類 (同時実行またはレート)。 |
| maxRequests | string | 許容される最大リクエスト数 - 同時実行またはレート。 |
| periodInSeconds | string | レートまたは同時実行の制限を超えたときに適用される期間 (秒単位)。 |
| version | string | 現在のスロットル コントラクトのバージョン。 |


## Related topics

- [TitleId Element (MicrosoftGame.config)](https://devdocs.xbox.com/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-titleid.md)
- [TitleId 요소(MicrosoftGame.config)](https://devdocs.xbox.com/ko/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-titleid.md)
- [TitleId 元素 (MicrosoftGame.config)](https://devdocs.xbox.com/zh-CN/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-titleid.md)
- [Élément MicrosoftGame.config - TitleId](https://devdocs.xbox.com/fr/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-titleid.md)
- [TitleId 要素 (MicrosoftGame.config)](https://devdocs.xbox.com/ja-jp/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-titleid.md)