> ## 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. # GET (/users/xuid({xuid})/groups/{moniker}/broadcasting ) > GET (/users/xuid({xuid})/groups/{moniker}/broadcasting ) # GET (/users/xuid({xuid})/groups/{moniker}/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](#ID4EV) * [Parâmetros de URI](#ID4E5) * [Parâmetros da cadeia de consulta](#ID4EJB) * [Autorização](#ID4EKC) * [Efeito das configurações de privacidade no recurso](#ID4EQD) * [Cabeçalhos de solicitação obrigatórios](#ID4EEH) * [Cabeçalhos de solicitação opcionais](#ID4EMBAC) * [Corpo da solicitação](#ID4EMCAC) * [Códigos de status HTTP](#ID4EXCAC) * [Cabeçalhos de resposta obrigatórios](#ID4E3GAC) * [Cabeçalhos de resposta opcionais](#ID4EMJAC) * [Corpo da resposta](#ID4E5KAC) ## 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âmetro | Tipo | Descrição | | - | - | - | | xuid | string | ID de usuário do XBOX (XUID) do usuário relacionado aos XUIDs no grupo. | | moniker | string | Cadeia de caracteres que define o grupo de usuários. No momento, o único moniker aceito é "People", com "P" maiúsculo. | ## 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=\;\".| \| 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](/pt-BR/reference/live/rest/additional/httpstatuscodes). \| 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 ```cpp theme={null} [ { xuid:"0123456789", state:"online", devices: [ { type:"D", titles: [ { id:"12341234", name:"Halo 5", lastModified:"2012-09-17T07:15:23.4930000", placement:"full", state:"active", activity: { richPresence:"Playing on Valhalla", broadcast: { "id":"broadcast id from broadcasting service", "session":"3f2504e0-4f89-11d3-9a0c-0305e82c3301", "provider":"Twitch", "started":"2014-01-15T15:15:23.493Z", "viewers":42 } }, } ] } ] }, { xuid:"0123456780", state:"online", devices: [ { type:"D", titles: [ { id:"12341235", name:"Halo Waypoint", lastModified:"2012-09-17T07:15:23.4930000", placement;"full", state:"active", activity: { richPresence:"Viewing stats" }, } ] } ] }, { xuid:"0123456781", state:"online", devices: [ { type:"Win8", titles: [ { id:"23452345", name:"Halo Gamehelp", state:"active", timestamp:"2012-09-17T07:15:23.4930000", activity: { richPresence:"Viewing warthog help" } } ] } ] } ] ``` ## Confira também ##### Pai [/users/xuid({xuid})/groups/{moniker}](/pt-BR/reference/live/rest/uri/presence/uri-usersxuidgroupsmoniker) ## Related topics - [XblUserStatisticsGetSingleUserStatisticsAsync](/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticsasync.md) - [XblUserStatisticsGetSingleUserStatisticAsync](/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticasync.md)