canal: doesUserHaveAccess
Namespace: microsoft.graph
Determine se um usuário tem acesso a um canal compartilhado.
Essa API está disponível nas seguintes implantações nacionais de nuvem.
| Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
| Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | ChannelMember.Read.All | ChannelMember.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Aplicativo | ChannelMember.Read.All | ChannelMember.ReadWrite.All |
Solicitação HTTP
GET /teams/{team-id}/channels/{channel-id}/doesUserHaveAccess(userId='@userId',tenantId='@tenantId',userPrincipalName='@userPrincipalName')
Parâmetros de função
Na URL da solicitação, forneça os seguintes parâmetros de consulta com valores. A tabela a seguir mostra os parâmetros que podem ser usados com esta função.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| tenantId | String | A ID do locatário Microsoft Entra ao qual o usuário pertence. O valor padrão dessa propriedade é o locatário atualId do usuário ou aplicativo conectado. |
| userId | Cadeia de caracteres | Identificador exclusivo para o usuário. Especifique a propriedade userId ou userPrincipalName na solicitação. |
| userPrincipalName | Cadeia de caracteres | O nome da entidade de usuário (UPN) do usuário. Especifique a propriedade userId ou userPrincipalName na solicitação. |
Cabeçalhos de solicitação
| Nome | Descrição |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Corpo da solicitação
Não forneça um corpo de solicitação para essa função.
Resposta
Se tiver êxito, essa função retornará o código resposta 200 OK e um Booliano no corpo da resposta.
Exemplos
Exemplo 1: verificar o acesso de um usuário interno
O exemplo a seguir mostra uma solicitação que verifica se um usuário interno tem acesso a um canal compartilhado.
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/v1.0/teams/0fddfdc5-f319-491f-a514-be1bc1bf9ddc/channels/19:33b76eea88574bd1969dca37e2b7a819@thread.skype/doesUserHaveAccess(userId='6285581f-484b-4845-9e01-60667f8b12ae')
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": true
}
Exemplo 2: verificar o acesso de um usuário externo
O exemplo a seguir mostra uma solicitação que usa a propriedade tenantId para marcar se um usuário externo tem acesso a um canal compartilhado.
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/v1.0/teams/0fddfdc5-f319-491f-a514-be1bc1bf9ddc/channels/19:33b76eea88574bd1969dca37e2b7a819@thread.skype/doesUserHaveAccess(userId='62855810-484b-4823-9e01-60667f8b12ae', tenantId='57fb72d0-d811-46f4-8947-305e6072eaa5')
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": true
}
Exemplo 3: verificar o acesso do usuário a um usuário usando o nome da entidade de usuário
O exemplo a seguir mostra uma solicitação que usa a propriedade userPrincipalName para marcar se um usuário interno tem acesso a um canal compartilhado.
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/v1.0/teams/0fddfdc5-f319-491f-a514-be1bc1bf9ddc/channels/19:33b76eea88574bd1969dca37e2b7a819@thread.skype/doesUserHaveAccess(userPrincipalName='john.doe@contoso.com')
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": false
}