> ## 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.

# Publier un groupe de joueurs récents (serveur)

> Publier un groupe de joueurs récents (serveur)

# Publier un groupe de joueurs récents (serveur)

Ajoute ou met à jour les joueurs récents de tous les utilisateurs d'un groupe (bidirectionnel).

Cette API permet à un serveur de jeu d'ajouter des éléments aux listes de joueurs récents d'un ensemble d'utilisateurs et de mettre à jour les entrées de joueurs récents existantes. Tous les utilisateurs d'un groupe sont ajoutés aux listes de joueurs récents les uns des autres (bidirectionnel).

Exemple de groupes de joueurs récents : \[ \[A,B,C], \[A,D], \[E,F] ].

A a rencontré B, C et D. B a rencontré A et C. D n'a rencontré que A, et ainsi de suite.

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

<a id="uri-parameters" />

## Paramètres d'URI

| Paramètre | Dans | Obligatoire | Type | Description |
| - | - | - | - | - |
| titleId | chemin | TRUE | entier | Le titleId du jeu pour lequel la requête est envoyée. |

<a id="request-header" />

## En-tête de la requête

| Nom | Obligatoire | Type | Description |
| - | - | - | - |
| Authorization | TRUE | entier | L'appelant doit fournir un XToken au format d'autorisation XBL 3.0. Par exemple, Authorization: XBL3.0 x=2553948354698;>jeton chiffré\<) |
| Content-Type | TRUE | chaîne | ContentType doit être défini sur application/json |

<a id="request-body" />

## Corps de la requête

| Nom | Obligatoire | Type | Description |
| - | - | - | - |
| recentPlayerGroups | TRUE | [RecentPlayerGroup](#recentplayergroup)\[] | Le tableau des groupes de joueurs récents bidirectionnels. Il doit y avoir au moins 1 groupe et au plus 20 groupes. Chaque groupe doit compter au moins 2 joueurs et au plus 100. |

<a id="responses" />

## Réponses

| Nom | Type | Description |
| - | - | - |
| 204 No Content | | La requête de joueurs récents a été envoyée avec succès. |
| 400 Bad Request | [ErrorResponse](#errorresponse) | Une erreur s'est produite lors du traitement de la requête. Codes d'erreur possibles : "RequestValidationError: The request validation has failed.", " AuthorizationError: The caller is not allowed to access the resource." |
| Autres codes d'état | [ThrottledEntity](#throttledentity) | Trop de requêtes. En-têtes Retry-After: integer |

<a id="definitions" />

## Définitions

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

<a id="bidirectionalrecentplayer" />

### BidirectionalRecentPlayer

| Nom | Type | Description |
| - | - | - |
| id | chaîne | L'ID (un XUID sous forme d'entier en base 10) d'un autre utilisateur. |
| network | [Network](#network) | Le réseau sur lequel l'autre utilisateur a été rencontré. |

<a id="encountertype" />

### EncounterType

Le type de rencontre de joueurs récents. Ce champ est facultatif et sa valeur par défaut est Default. Default n'a pas de signification prescrite - il revient à l'appelant d'interpréter cette valeur de façon appropriée.

| Nom | Type | Description |
| - | - | - |
| Default | chaîne | |
| Opponent | chaîne | |
| Teammate | chaîne | |

<a id="errorresponse" />

### ErrorResponse

| Nom | Type | Description |
| - | - | - |
| debugMessage | chaîne | Version lisible du message d'erreur pouvant être utilisée pour le débogage. |
| errorCode | chaîne | Énumération du code d'erreur. |

<a id="network" />

### Network

| Nom | Type | Description |
| - | - | - |
| XboxLive | chaîne | |

<a id="recentplayergroup" />

### RecentPlayerGroup

Tous les utilisateurs d'un groupe se sont rencontrés à l'heure spécifiée. Chaque groupe doit contenir au moins 2 et jusqu'à 100 utilisateurs.

| Nom | Type | Description |
| - | - | - |
| encounterType | [EncounterType](#encountertype) | Le type de rencontre de joueurs récents. Ce champ est facultatif et sa valeur par défaut est Default. Default n'a pas de signification prescrite - il revient à l'appelant d'interpréter cette valeur de façon appropriée. |
| recentPlayers | [BidirectionalRecentPlayer](#bidirectionalrecentplayer)\[] | |
| timestamp | chaîne | |

<a id="serverrecentplayergroupsrequest" />

### ServerRecentPlayerGroupsRequest

Tous les utilisateurs d'un groupe se sont rencontrés à l'heure spécifiée. Chaque groupe doit contenir au moins 2 et jusqu'à 100 utilisateurs.

| Nom | Type | Description |
| - | - | - |
| recentPlayerGroups | [RecentPlayerGroup](#recentplayergroup) | Le tableau des groupes de joueurs récents bidirectionnels. Il doit y avoir au moins 1 groupe et au plus 20 groupes. Chaque groupe doit compter au moins 2 joueurs et au plus 100. |

<a id="throttledentity" />

### ThrottledEntity

| Nom | Type | Description |
| - | - | - |
| currentRequests | chaîne | Nombre actuel de requêtes - simultanéité ou débit. |
| debugMessage | chaîne | Version lisible du message de limitation pouvant être utilisée pour le débogage. |
| limitType | chaîne | Le type de limite, c'est-à-dire simultanéité ou débit. |
| maxRequests | chaîne | Nombre maximal de requêtes autorisées - simultanéité ou débit. |
| periodInSeconds | chaîne | La période en secondes qui s'applique lorsque les limites de débit ou de simultanéité sont dépassées. |
| version | chaîne | Version actuelle du contrat de limitation. |


## Related topics

- [Joueurs récents](/fr-CA/services/xbox-services/multiplayer/mpa/concepts/live-mpa-recent-players.md)
- [XR-067 Maintien des interactions Joueurs récents](/fr-CA/publishing/certification/xr/xr-067.md)
- [Groupes d'entités](/fr/services/playfab/community/associations/groups/quickstart.md)
- [Options de test préalables à la sortie](/fr/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-prerelease.md)
- [Créer un lobby](/fr/services/playfab/multiplayer/lobby/create-a-lobby.md)
