> ## 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 (/handles/query?include=relatedInfo) > POST (/handles/query?include=relatedInfo) # POST (/handles/query?include=relatedInfo) Crea consultas de identificadores de sesión que incluyen información de sesión relacionada. > **Importante:**\ > Este método lo usa el multijugador de 2015 y se aplica únicamente a esa versión multijugador y posteriores. Está pensado para usarse con el contrato de plantilla 104/105 o posterior, y requiere un elemento de encabezado X-Xbl-Contract-Version: 104/105 o posterior en cada solicitud. * [Comentarios](#ID4ET) * [Parámetros de URI](#ID4ECB) * [Parámetros de cadena de consulta](#ID4EPB) * [Códigos de estado HTTP](#ID4EAF) * [Cuerpo de la solicitud](#ID4EHF) * [Cuerpo de la respuesta](#ID4EZF) ## Comentarios Este método HTTP/REST crea consultas de datos de identificadores con la información de sesión especificada en la cadena de consulta "include". El valor de la cadena de consulta está diseñado para ser extensible y admitir opciones de consulta futuras, admitiendo una lista delimitada por comas, por ejemplo, "?include=relatedInfo,session". El método POST puede encapsularse mediante **Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetActivitiesForUsersAsync**. El campo de tipo del cuerpo de la solicitud para este método debe establecerse en "activity". Los elementos del cuerpo de la respuesta se asignan directamente a las propiedades de **Microsoft.Xbox.Services.Multiplayer.MultiplayerActivityDetails**. ## Parámetros de URI ## Parámetros de cadena de consulta Una consulta puede modificarse mediante los parámetros de cadena de consulta de la tabla siguiente. \| **Parámetro**| **Tipo**| **Descripción**| \| --- | --- | --- | --- | \| keyword| string| Una palabra clave, por ejemplo, "foo", que debe encontrarse en las sesiones o plantillas para que se recuperen. | \| xuid| Entero de 64 bits sin signo| El identificador de usuario de XBOX, por ejemplo, "123", de las sesiones que se incluirán en la consulta. De forma predeterminada, el usuario debe estar activo en la sesión para que esta se incluya. | \| reservations| Valor booleano| True para incluir las sesiones en las que el usuario está establecido como jugador reservado pero no se ha unido para convertirse en jugador activo. Este parámetro solo se usa al consultar sus propias sesiones, o al consultar las sesiones de un usuario específico de servidor a servidor. | \| inactive| Valor booleano| True para incluir las sesiones que el usuario ha aceptado pero en las que no está jugando activamente. Las sesiones en las que el usuario está "ready" pero no "active" cuentan como inactivas. | \| private| Valor booleano| True para incluir las sesiones privadas. Este parámetro solo se usa al consultar sus propias sesiones, o al consultar las sesiones de un usuario específico de servidor a servidor. | \| visibility| string| Estado de visibilidad de las sesiones. Los valores posibles los define **Microsoft.Xbox.Services.Multiplayer.MultiplayerSessionVisibility**. Si este parámetro se establece en "open", la consulta debe incluir solo las sesiones abiertas. Si se establece en "private", el parámetro *private* debe establecerse en true. | \| version| Entero de 32 bits con signo| La versión máxima de sesión que debe incluirse. Por ejemplo, un valor de 2 especifica que solo deben incluirse las sesiones con una versión principal de sesión de 2 o inferior. El número de versión debe ser menor o igual que la versión del contrato de la solicitud módulo 100. | \| take| Entero de 32 bits con signo| El número máximo de sesiones que se recuperarán. Este número debe estar entre 0 y 100. | Establecer *private* o *reservations* en true requiere acceso de nivel de servidor a la sesión. Como alternativa, estas configuraciones requieren que la notificación XUID del autor de la llamada coincida con el filtro XUID del URI. De lo contrario, se devuelve el código de estado HTTP/403, existan o no realmente dichas sesiones. ## Códigos de estado HTTP El servicio devuelve un código de estado HTTP según se aplica al MPSD. ## Cuerpo de la solicitud ### Ejemplo de solicitud Para obtener todas las actividades del gráfico social de "favoritos" de un usuario, el cuerpo del POST tiene este aspecto: ```cpp theme={null} { "type": "activity", "scid": "B5B1F71F-A328-4371-89E0-C3AD222D0E92" // optional filter on scid "owners": { "people": { "moniker": "favorites", "monikerXuid": "3210" } } } ``` ## Cuerpo de la respuesta Los resultados se devuelven como una matriz de estructuras de identificador, con un ID único incrustado en cada identificador. La información específica de la sesión se devuelve en el objeto **relatedInfo**. Tenga en cuenta que esta información no se devuelve para el método POST normal en este URI. ### Ejemplo de respuesta ```cpp theme={null} { "results": [{ "id": "11111111-ebe0-42da-885f-033860a818f6", "type": "activity", "version": 1, "sessionRef": { "scid": "8dfb0100-ebe0-42da-885f-033860a818f6", "templateName": "party", "name": "e3a836aeac6f4cbe9bcab985494d3175" }, "titleId": "1234567", "ownerXuid": "3212", // Only if ?include=relatedInfo "relatedInfo": { "visibility": "open", "joinRestriction": "followed", "closed": true, "maxMembersCount": 8, "membersCount": 4, } }, { "id": "11111111-ebe0-42da-885f-033860a818f7", "type": "activity", "version": 1, "sessionRef": { "scid": "8dfb0100-ebe0-42da-885f-033860a818f6", "templateName": "TitleStorageTestDefault", "name": "795fcaa7-8377-4281-bd7e-e86c12843632" }, "titleId": "1234567", "ownerXuid": "3212", // Only if ?include=relatedInfo "relatedInfo": { "visibility": "open", "joinRestriction": "followed", "closed": false, "maxMembersCount": 8, "membersCount": 4, } }] } ``` ## Consulte también ##### Elemento primario [/handles/query](https://docs.xbox.com/es/reference/live/rest/uri/sessiondirectory/uri-handlesquery.md) ## Related topics - [/handles/query](https://docs.xbox.com/es/reference/live/rest/uri/sessiondirectory/uri-handlesquery.md) - [POST (/handles/query)](https://docs.xbox.com/es/reference/live/rest/uri/sessiondirectory/uri-handlesquerypost.md) - [Query](https://docs.xbox.com/es/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_query.md) - [URI del directorio de sesiones](https://docs.xbox.com/es/reference/live/rest/uri/sessiondirectory/atoc-reference-sessiondirectory.md) - [POST (/handles)](https://docs.xbox.com/es/reference/live/rest/uri/sessiondirectory/uri-handlespost.md)