Skip to main content

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

Recupera o registro de presença dos usuários que estão transmitindo, especificados pelo moniker de grupos relacionado ao XUID que aparece no URI. O domínio desses URIs é userpresence.xboxlive.com.

Comentários

Acessa o registro de presença dos usuários que estão transmitindo, especificados pelo moniker de grupos relacionado ao XUID que aparece no URI.

Parâmetros de URI

Parâmetros da cadeia de consulta

| Parâmetro| Tipo| Descrição| | --- | --- | --- | --- | --- | --- | | level| string| Retorna o nível de detalhe especificado por esta cadeia de consulta. As opções válidas incluem “user”, “device”, “title” e “all”. O nível “user” é o objeto PresenceRecord sem o objeto aninhado DeviceRecord. O nível “device” corresponde aos objetos PresenceRecord e DeviceRecord sem o objeto aninhado TitleRecord. O nível “title” corresponde aos objetos PresenceRecord, DeviceRecord e TitleRecord sem o objeto aninhado ActivityRecord. O nível “all” é o registro inteiro, incluindo todos os objetos aninhados. Se esse parâmetro não for fornecido, o serviço usará como padrão o nível title (ou seja, retornará a presença desse usuário até os detalhes do título).|

Autorização

Declarações de autorização usadas | Declaração| Tipo| Obrigatório?| Valor de exemplo| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Xuid| inteiro com sinal de 64 bits| sim| 1234567890|

Efeito das configurações de privacidade no recurso

O serviço sempre retornará 200 OK se a própria solicitação estiver bem formada. No entanto, ele filtrará informações da resposta quando as verificações de privacidade não forem aprovadas. Efeito das configurações de privacidade no recurso | Usuário solicitante| Configuração de privacidade do usuário de destino| Comportamento| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | eu| -| Conforme descrito.| | amigo| todos| Conforme descrito.| | amigo| somente amigos| Conforme descrito.| | amigo| bloqueado| Conforme descrito; o serviço filtrará os dados.| | usuário não amigo| todos| Conforme descrito.| | usuário não amigo| somente amigos| Conforme descrito; o serviço filtrará os dados.| | usuário não amigo| bloqueado| Conforme descrito; o serviço filtrará os dados.| | site de terceiros| todos| Conforme descrito; o serviço filtrará os dados.| | site de terceiros| somente amigos| Conforme descrito; o serviço filtrará os dados.| | site de terceiros| bloqueado| Conforme descrito; o serviço filtrará os dados.|

Cabeçalhos de solicitação obrigatórios

| Cabeçalho| Tipo| Descrição| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| string| Credenciais de autenticação para autenticação HTTP. Valor de exemplo: “XBL3.0 x=<userhash>;<token>”.| | x-xbl-contract-version| string| Nome/número do build do serviço XBOX LIVE para o qual esta solicitação deve ser direcionada. A solicitação só será roteada para esse serviço após a verificação da validade do cabeçalho, das declarações no token de autenticação e assim por diante. Valores de exemplo: 3, vnext.| | Accept| string| Content-Types aceitáveis. O único compatível com Presence é application/json, mas ele ainda deve ser especificado no cabeçalho.| | Accept-Language| string| Localidade aceitável para as cadeias de caracteres na resposta. Valor de exemplo: en-US.| | Host| string| Nome de domínio do servidor. Valor de exemplo: userpresence.xboxlive.com.|

Cabeçalhos de solicitação opcionais

| Cabeçalho| Tipo| Descrição| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion| | Nome/número do build do serviço XBOX LIVE para o qual esta solicitação deve ser direcionada. A solicitação só será roteada para esse serviço após a verificação da validade do cabeçalho, das declarações no token de autenticação e assim por diante. Valor padrão: 1.|

Corpo da solicitação

Nenhum objeto é enviado no corpo desta solicitação.

Códigos de status HTTP

O serviço retorna um dos códigos de status desta seção em resposta a uma solicitação feita com este método neste recurso. Para obter uma lista completa dos códigos de status HTTP padrão usados com os XBOX Live Services, confira Códigos de status HTTP padrão. | Código| Frase de motivo| Descrição| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK| A sessão foi recuperada com sucesso.| | 400| Bad Request| O serviço não conseguiu entender a solicitação malformada. Normalmente, um parâmetro inválido.| | 401| Unauthorized| A solicitação exige autenticação do usuário.| | 403| Forbidden| A solicitação não é permitida para o usuário ou serviço.| | 404| Not Found| Não foi possível encontrar o recurso especificado.| | 405| Method Not Allowed| O método HTTP foi usado em um tipo de conteúdo sem suporte.| | 406| Not Acceptable| A versão do recurso não é compatível.| | 500| Request Timeout| O serviço não conseguiu entender a solicitação malformada. Normalmente, um parâmetro inválido.| | 503| Request Timeout| O serviço não conseguiu entender a solicitação malformada. Normalmente, um parâmetro inválido.|

Cabeçalhos de resposta obrigatórios

| Cabeçalho| Tipo| Descrição| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | x-xbl-contract-version| string| Nome/número do build do serviço XBOX LIVE para o qual esta solicitação deve ser direcionada. A solicitação só será roteada para esse serviço após a verificação da validade do cabeçalho, das declarações no token de autenticação e assim por diante. Valores de exemplo: 1, vnext.| | Content-Type| string| O tipo MIME do corpo da solicitação. Valor de exemplo: application/json.| | Cache-Control| string| Solicitação educada para especificar o comportamento de cache. Valores de exemplo: “no-cache”.| | X-XblCorrelationId| string| Valor gerado pelo serviço para correlacionar o que o servidor retorna e o que o cliente recebe. Valor de exemplo: “4106d0bc-1cb3-47bd-83fd-57d041c6febe”.| | X-Content-Type-Option| string| Retorna o valor compatível com SDL. Valor de exemplo: “nosniff”.| | Date| string| A data/hora em que a mensagem foi enviada. Valor de exemplo: “Tue, 17 Nov 2012 10:33:31 GMT”.|

Cabeçalhos de resposta opcionais

| Cabeçalho| Tipo| Descrição| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Retry-After| string| Retornado em erros HTTP 503. Informa ao cliente quanto tempo aguardar antes de repetir a chamada. Valores de exemplo: “120”.| | Content-Length| string| Comprimento do corpo da resposta. Valor de exemplo: “527”.| | Content-Encoding| string| Tipo de codificação da resposta. Valor de exemplo: “gzip”.|

Corpo da resposta

Esta API recupera o registro de presença dos usuários que estão transmitindo, especificados pelo moniker de grupos relacionado ao XUID que aparece no URI.

Exemplo de resposta

Confira também

Pai
/users/xuid()/groups/
Last modified on October 6, 2026