Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Obtenha a lista de canais de entrada (canais compartilhados com uma equipe).
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global | Governo dos EUA L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos 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 com privilégios mais elevados |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | Channel.ReadBasic.All | ChannelSettings.Read.All, ChannelSettings.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | Channel.ReadBasic.All | ChannelSettings.Read.All, ChannelSettings.ReadWrite.All |
Observação: esta API oferece transporte a permissões de administrador. Os administradores de serviços do Microsoft Teams podem acessar equipes das quais não são membros.
Solicitação HTTP
GET /teams/{team-id}/incomingChannels
Parâmetros de consulta opcionais
Este método oferece suporte aos $filter e $selectparâ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 réplica 200 OK e uma coleção de objetos de canal no corpo da réplica. A réplica também inclui a propriedade @odata.id que pode ser usada para acessar o canal e executar outras operações no objeto de canal.
Quando o conjunto de resultados abrange várias páginas, a resposta inclui uma propriedade @odata.nextLink com uma URL para recuperar a próxima página de resultados. Para obter detalhes sobre como percorrer os resultados, consulte Paginação de dados do Microsoft Graph em seu aplicativo.
Observação
Atualmente, a invocação do URL retornado da propriedade @odata.id falha para canais compartilhados entre locatários. Você pode resolver esse problema se remover a parte /tenants/{tenant-id} do URL antes de chamar essa API. Para obter mais detalhes, consulte Problemas conhecidos com o Microsoft Graph.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/v1.0/teams/893075dd-2487-4122-925f-022c42e20265/incomingChannels
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"@odata.id": "https://graph.microsoft.com/v1.0/tenants/b3246f44-b4gb-4627-96c6-25b18fa2c910/teams/893075dd-5678-4122-925f-022c42e20265/channels/19:561fbdbbfca848a484f0a6f00ce9dbbd@thread.tacv2",
"id": "19:561fbdbbfca848a484f0a6f00ce9dbbd@thread.tacv2",
"createdDateTime": "2020-05-27T19:22:25.692Z",
"displayName": "Contoso Sales channel",
"description": "channel created in Contoso to be shared with other teams/tenants.",
"membershipType": "shared",
"layoutType": null,
"tenantId": "b3246f44-b4gb-4627-96c6-25b18fa2c910"
}
]
}
Observação
Essa API tem um problema conhecido relacionado aos canais de listagem. A propriedade layoutType retorna null ao listar canais. Para obter o tipo de layout de um canal específico, use a API Obter canal . Há suporte completo para layoutType em operações de lista para uma versão futura.