Skip to main content

​
GET (/users/xuid()/groups//broadcasting/count )

Recupera el recuento de los usuarios que están transmitiendo especificados por el moniker de grupos relacionado con el XUID que aparece en el URI. El dominio de estos URI es userpresence.xboxlive.com.

​
Comentarios

Recupera el recuento de los usuarios que están transmitiendo especificados por el moniker de grupos relacionado con el XUID que aparece en el URI.

​
Parámetros de URI

​
Parámetros de cadena de consulta

| Parámetro| Tipo| Descripción| | --- | --- | --- | --- | --- | --- | | level| string| Devuelve el nivel de detalle especificado por esta cadena de consulta. Las opciones válidas son “user”, “device”, “title” y “all”. El nivel “user” es el objeto PresenceRecord sin el objeto anidado DeviceRecord. El nivel “device” son los objetos PresenceRecord y DeviceRecord sin el objeto anidado TitleRecord. El nivel “title” son los objetos PresenceRecord, DeviceRecord y TitleRecord sin el objeto anidado ActivityRecord. El nivel “all” es el registro completo, incluidos todos los objetos anidados. Si no se proporciona este parámetro, el servicio usa de forma predeterminada el nivel de título (es decir, devuelve la presencia de este usuario hasta el nivel de detalle del título).|

​
Autorización

Notificaciones de autorización usadas | Notificación| Tipo| ¿Obligatoria?| Valor de ejemplo| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Xuid| Entero con signo de 64 bits| sí| 1234567890|

​
Efecto de la configuración de privacidad en el recurso

El servicio siempre devolverá 200 OK si la propia solicitud tiene el formato correcto. Sin embargo, filtrará la información de la respuesta cuando no se superen las comprobaciones de privacidad. Efecto de la configuración de privacidad en el recurso | Usuario solicitante| Configuración de privacidad del usuario de destino| Comportamiento| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | yo| -| Como se describe.| | amigo| todos| Como se describe.| | amigo| solo amigos| Como se describe.| | amigo| bloqueado| Como se describe: el servicio filtrará los datos.| | usuario no amigo| todos| Como se describe.| | usuario no amigo| solo amigos| Como se describe: el servicio filtrará los datos.| | usuario no amigo| bloqueado| Como se describe: el servicio filtrará los datos.| | sitio de terceros| todos| Como se describe: el servicio filtrará los datos.| | sitio de terceros| solo amigos| Como se describe: el servicio filtrará los datos.| | sitio de terceros| bloqueado| Como se describe: el servicio filtrará los datos.|

​
Encabezados de solicitud obligatorios

| Encabezado| Tipo| Descripción| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| string| Credenciales de autenticación para la autenticación HTTP. Valor de ejemplo: “XBL3.0 x=<userhash>;<token>”.| | x-xbl-contract-version| string| Nombre o número de compilación del servicio XBOX LIVE al que se debe dirigir esta solicitud. La solicitud solo se enrutará a ese servicio después de comprobar la validez del encabezado, las notificaciones del token de autenticación, etc. Valores de ejemplo: 3, vnext.| | Accept| string| Tipos de contenido aceptables. El único que admite Presence es application/json, pero aun así se debe especificar en el encabezado.| | Accept-Language| string| Configuración regional aceptable para las cadenas de la respuesta. Valor de ejemplo: en-US.| | Host| string| Nombre de dominio del servidor. Valor de ejemplo: userpresence.xboxlive.com.|

​
Encabezados de solicitud opcionales

| Encabezado| Tipo| Descripción| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion| | Nombre o número de compilación del servicio XBOX LIVE al que se debe dirigir esta solicitud. La solicitud solo se enrutará a ese servicio después de comprobar la validez del encabezado, las notificaciones del token de autenticación, etc. Valor predeterminado: 1.|

​
Cuerpo de la solicitud

No se envía ningún objeto en el cuerpo de esta solicitud.

​
Códigos de estado HTTP

El servicio devuelve uno de los códigos de estado de esta sección en respuesta a una solicitud realizada con este método en este recurso. Para obtener una lista completa de los códigos de estado HTTP estándar que se usan con XBOX Live Services, consulte Códigos de estado HTTP estándar. | Código| Frase de motivo| Descripción| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK| La sesión se recuperó correctamente.| | 400| Solicitud incorrecta| El servicio no pudo entender una solicitud con formato incorrecto. Normalmente se trata de un parámetro no válido.| | 401| No autorizado| La solicitud requiere autenticación del usuario.| | 403| Prohibido| La solicitud no está permitida para el usuario o el servicio.| | 404| No encontrado| No se pudo encontrar el recurso especificado.| | 405| Método no permitido| Se usó un método HTTP en un tipo de contenido no compatible.| | 406| No aceptable| La versión del recurso no es compatible.| | 500| Tiempo de espera de la solicitud| El servicio no pudo entender una solicitud con formato incorrecto. Normalmente se trata de un parámetro no válido.| | 503| Tiempo de espera de la solicitud| El servicio no pudo entender una solicitud con formato incorrecto. Normalmente se trata de un parámetro no válido.|

​
Encabezados de respuesta obligatorios

| Encabezado| Tipo| Descripción| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | x-xbl-contract-version| string| Nombre o número de compilación del servicio XBOX LIVE al que se debe dirigir esta solicitud. La solicitud solo se enrutará a ese servicio después de comprobar la validez del encabezado, las notificaciones del token de autenticación, etc. Valores de ejemplo: 1, vnext.| | Content-Type| string| Tipo MIME del cuerpo de la solicitud. Valor de ejemplo: application/json.| | Cache-Control| string| Solicitud de cortesía para especificar el comportamiento de almacenamiento en caché. Valores de ejemplo: “no-cache”.| | X-XblCorrelationId| string| Valor generado por el servicio para correlacionar lo que devuelve el servidor y lo que recibe el cliente. Valor de ejemplo: “4106d0bc-1cb3-47bd-83fd-57d041c6febe”.| | X-Content-Type-Option| string| Devuelve el valor conforme a SDL. Valor de ejemplo: “nosniff”.| | Date| string| Fecha y hora en que se envió el mensaje. Valor de ejemplo: “Tue, 17 Nov 2012 10:33:31 GMT”.|

​
Encabezados de respuesta opcionales

| Encabezado| Tipo| Descripción| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Retry-After| string| Se devuelve en errores HTTP 503. Indica al cliente cuánto tiempo debe esperar antes de reintentar la llamada. Valores de ejemplo: “120”.| | Content-Length| string| Longitud del cuerpo de la respuesta. Valor de ejemplo: “527”.| | Content-Encoding| string| Tipo de codificación de la respuesta. Valor de ejemplo: “gzip”.|

​
Cuerpo de la respuesta

Esta API devuelve un recuento del número actual de transmisiones según los parámetros.

​
Respuesta de ejemplo

​
Consulte también

Elemento primario
/users/xuid()/groups/
Last modified on October 19, 2026