Get primaryChannelGet primaryChannel

Namespace: Microsoft GraphNamespace: microsoft.graph

Obtenha o canal padrão, Geral , de uma equipe.Get the default channel, General , of a team.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.AllChannel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
ApplicationApplication ChannelSettings.Read.Group , ChannelSettings.ReadWrite.Group , Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.AllChannelSettings.Read.Group , ChannelSettings.ReadWrite.Group , Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All

Observação : Permissões marcadas com * usam consentimento específico de recurso.Note : Permissions marked with * use resource-specific consent.

Observação : esta API oferece transporte a permissões de administrador.Note : This API supports admin permissions. Os administradores globais e os administradores do serviço do Microsoft Teams podem acessar equipes das quais eles não são membros.Global admins and Microsoft Teams service admins can access teams that they are not a member of.

Solicitação HTTPHTTP request

GET /teams/{id}/primaryChannel

Parâmetros de consulta opcionaisOptional query parameters

Este método suporta o $filter, $select, e $expand parâmetros de consulta OData para ajudar a personalizar a resposta.This method supports the $filter, $select, and $expand OData query parameters to help customize the response.

Cabeçalhos de solicitaçãoRequest headers

CabeçalhoHeader ValorValue
AutorizaçãoAuthorization {token} de portador. Obrigatório.Bearer {token}. Required.

Corpo da solicitaçãoRequest body

Não forneça um corpo de solicitação para esse método.Do not supply a request body for this method.

RespostaResponse

Se tiver êxito, este método retornará um código de resposta 200 OK e um objeto canal no corpo da resposta.If successful, this method returns a 200 OK response code and a channel object in the response body.

ExemploExample

SolicitaçãoRequest

Este é um exemplo de solicitação.The following is an example of the request.

GET https://graph.microsoft.com/v1.0/teams/{id}/primaryChannel

RespostaResponse

Este é um exemplo de resposta.The following is an example of the response.

Observação: o objeto response mostrado aqui pode ser encurtado para legibilidade. Todas as propriedades serão retornadas de uma chamada real.Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 401

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('32e3b156-66b2-4135-9aeb-73295a35a55b')/primaryChannel/$entity",
    "id": "19:skypespaces_dd1e128ffa85453ab1f3015468e979d5@thread.skype",
    "displayName": "General",
    "description": "Microsoft Teams Platform team discussions",
    "email": "0686dc7a.microsoft.com@amer.teams.ms",
    "webUrl": "https://teams.microsoft.com/l/channel/19%3askypespaces_dd1e128ffa85453ab1f3015468e979d5%40thread.skype/General?groupId=32e3b156-66b2-4135-9aeb-73295a35a55b&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47"
}