Listar sharedWithChannelTeamInfo
Namespace: microsoft.graph
Obtenha a lista deequipes com a qual foi compartilhado um canal especificado. Esta operação é permitida somente para canais com valor membershipType de shared
.
Esta API está disponível nas seguintes implementações de cloud nacionais.
Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Permissões
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
---|---|---|
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 |
Observação: esta API oferece transporte a permissões de administrador. Os administradores de serviços do Microsoft Teams podem aceder às equipas das quais não são membros.
Solicitação HTTP
GET /teams/{team-id}/channels/{channel-id}/sharedWithTeams
Parâmetros de consulta opcionais
Este método oferece suporte aos $filter
e $select
parâmetros de consulta OData para ajudar a personalizar a resposta.
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 esse método.
Resposta
Se for bem-sucedido, esse método retornará um código de resposta 200 OK
e uma coleção de objetos sharedWithChannelTeamInfo no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/v1.0/teams/893075dd-2487-4122-925f-022c42e20265/channels/19:561fbdbbfca848a484f0a6f00ce9dbbd@thread.tacv2/sharedWithTeams
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"@odata.type": "#microsoft.graph.sharedWithChannelTeamInfo",
"id": "2173de69-de69-2173-69de-732169de7321",
"tenantId": "b3246f44-b4gb-4627-96c6-25b18fa2c910",
"displayName": "Team Contoso",
"isHostTeam": true
},
{
"@odata.type": "#microsoft.graph.sharedWithChannelTeamInfo",
"id": "893075dd-2487-4122-86db-022c42e20265",
"displayName": "Team Fabrikam",
"isHostTeam": false,
"tenantId": "b3246f44-b4gb-5678-96c6-25b18fa2c910"
}
]
}