> ## 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}/recentplayergroups/server

> Publicar grupo de jugadores recientes del servidor

# Publicar grupo de jugadores recientes del servidor

Anexa a los jugadores recientes de todos los usuarios de un grupo o los actualiza (bidireccional).

Esta API permite que un servidor de juego anexe a las listas de jugadores recientes de un conjunto de usuarios, y actualice las entradas de jugadores recientes existentes. Todos los usuarios de un grupo se agregan a las listas de jugadores recientes de los demás (bidireccional).

Ejemplo de grupos de jugadores recientes: \[ \[A,B,C], \[A,D], \[E,F] ].

A se encontró con B, C y D. B se encontró con A y C. D solo se encontró con A, y así sucesivamente.

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

## Parámetros de URI

| Parámetro | En | Obligatorio | Tipo | Descripción |
| - | - | - | - | - |
| titleId | path | TRUE | integer | El titleId del juego para el que se envía la solicitud. |

## Encabezado de la solicitud

| Nombre | Obligatorio | Tipo | Descripción |
| - | - | - | - |
| Authorization | TRUE | integer | El autor de la llamada debe proporcionar un XToken en el formato de autorización XBL 3.0. Por ejemplo, Authorization: XBL3.0 x=2553948354698;>encrypted token\<) |
| Content-Type | TRUE | string | ContentType debe establecerse en application/json |

## Cuerpo de la solicitud

| Nombre | Obligatorio | Tipo | Descripción |
| - | - | - | - |
| recentPlayerGroups | TRUE | [RecentPlayerGroup](#recentplayergroup)\[] | La matriz de grupos bidireccionales de jugadores recientes. Debe haber al menos 1 grupo y como máximo 20 grupos. Dentro de cada grupo, debe haber al menos 2 jugadores y como máximo 100. |

## Respuestas

| Nombre | Tipo | Descripción |
| - | - | - |
| 204 No Content | | La solicitud de jugadores recientes se envió correctamente. |
| 400 Bad Request | [ErrorResponse](#errorresponse) | Se produjo un error al procesar la solicitud. Códigos de error posibles: "RequestValidationError: The request validation has failed.", " AuthorizationError: The caller is not allowed to access the resource." |
| Otros códigos de estado | [ThrottledEntity](#throttledentity) | Demasiadas solicitudes. Encabezados Retry-After: integer |

## Definiciones

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

### BidirectionalRecentPlayer

| Nombre | Tipo | Descripción |
| - | - | - |
| id | string | El identificador (un XUID como entero en base 10) de otro usuario. |
| network | [Network](#network) | La red en la que se encontró al otro usuario. |

### EncounterType

El tipo de encuentro de jugadores recientes. Este campo es opcional y su valor predeterminado es Default. Default no tiene un significado prescrito; corresponde al autor de la llamada interpretar este valor de forma adecuada.

| Nombre | Tipo | Descripción |
| - | - | - |
| Default | string | |
| Opponent | string | |
| Teammate | string | |

### ErrorResponse

| Nombre | Tipo | Descripción |
| - | - | - |
| debugMessage | string | Versión legible del mensaje de error que se puede usar para depurar. |
| errorCode | string | Enumeración de códigos de error. |

### Network

| Nombre | Tipo | Descripción |
| - | - | - |
| XboxLive | string | |

### RecentPlayerGroup

Todos los usuarios de un grupo se han encontrado entre sí a la hora especificada. Cada grupo debe contener al menos 2 usuarios y como máximo 100.

| Nombre | Tipo | Descripción |
| - | - | - |
| encounterType | [EncounterType](#encountertype) | El tipo de encuentro de jugadores recientes. Este campo es opcional y su valor predeterminado es Default. Default no tiene un significado prescrito; corresponde al autor de la llamada interpretar este valor de forma adecuada. |
| recentPlayers | [BidirectionalRecentPlayer](#bidirectionalrecentplayer)\[] | |
| timestamp | string | |

### ServerRecentPlayerGroupsRequest

Todos los usuarios de un grupo se han encontrado entre sí a la hora especificada. Cada grupo debe contener al menos 2 usuarios y como máximo 100.

| Nombre | Tipo | Descripción |
| - | - | - |
| recentPlayerGroups | [RecentPlayerGroup](#recentplayergroup) | La matriz de grupos bidireccionales de jugadores recientes. Debe haber al menos 1 grupo y como máximo 20 grupos. Dentro de cada grupo, debe haber al menos 2 jugadores y como máximo 100. |

### ThrottledEntity

| Nombre | Tipo | Descripción |
| - | - | - |
| currentRequests | string | Número actual de solicitudes: simultaneidad o frecuencia. |
| debugMessage | string | Versión legible del mensaje de limitación que se puede usar para depurar. |
| limitType | string | El tipo de límite, es decir, simultaneidad o frecuencia. |
| maxRequests | string | Número máximo de solicitudes permitidas: simultaneidad o frecuencia. |
| periodInSeconds | string | El período en segundos que se aplica cuando se superan los límites de frecuencia o simultaneidad. |
| version | string | Versión actual del contrato de limitación. |


## Related topics

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