> ## 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/me/groups/{moniker} ) > GET (/users/me/groups/{moniker} ) # GET (/users/me/groups/{moniker} ) Obtém o PresenceRecord do meu grupo. 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 Recupera os usuários no grupo especificado pelo moniker relacionado ao usuário nas declarações e retorna o PresenceRecord desses usuários. Os dados restringidos pela Privacidade ou pelo Isolamento de Conteúdo simplesmente não serão retornados. ## Parâmetros de URI | Parâmetro | Tipo | Descrição | | - | - | - | | moniker | string | Cadeia de caracteres que define o grupo de usuários. O único moniker aceito no momento é "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" são os objetos PresenceRecord e DeviceRecord sem o objeto aninhado TitleRecord. O nível "title" são os objetos PresenceRecord, DeviceRecord e TitleRecord sem o objeto aninhado ActivityRecord. O nível "all" é o registro inteiro, incluindo todos os objetos aninhados. Se este parâmetro não for fornecido, o serviço usará por padrão o nível title (ou seja, retornará a presença deste 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 Serviços do XBOX Live, 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 êxito.| \| 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 requer 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| Não há suporte para a versão do recurso.| \| 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 é recebido pelo cliente. 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 retorna uma matriz de objetos PresenceRecord, um para cada um dos XUIDs da solicitação. ### Exemplo de resposta ```cpp theme={null} [ { xuid:"0123456789", state:"online", devices: [ { type:"D", titles: [ { id:"12341234", name:"Contoso 5", lastModified:"2012-09-17T07:15:23.4930000", placement:"full", state:"active", activity: { richPresence:"Playing on Nirvana" }, } ] } ] }, { xuid:"0123456780", state:"online", devices: [ { type:"D", titles: [ { id:"12341235", name:"Contoso 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:"Contoso Gamehelp", state:"active", timestamp:"2012-09-17T07:15:23.4930000", activity: { richPresence:"Viewing help" } } ] } ] } ] ``` ## Confira também ##### Pai [/users/me/groups/{moniker}](/pt-BR/reference/live/rest/uri/presence/uri-usersmegroupsmoniker) ## Related topics - [XUserGetAgeGroup](/reference/system/xuser/functions/xusergetagegroup.md) - [XblSocialManagerUserGroupGetUsersTrackedByGroup](/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerusergroupgetuserstrackedbygroup.md)