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
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Representa uma seção na lista de chat do Microsoft Teams de um usuário que organiza chats, canais e reuniões em grupos personalizados ou definidos pelo sistema. As seções podem ser definidas pelo usuário, permitindo que os usuários as criem, renomeiem e as excluam, ou definidas pelo sistema, que são gerenciadas pelo serviço.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| List | Trabalho em equipeColeção de seções | Obtenha a lista de seções do trabalho em equipe de um usuário. |
| Create | Trabalho em equipeSeção | Criar uma nova seção no trabalho em equipe de um usuário. |
| Get | Trabalho em equipeSeção | Leia as propriedades de uma seção no trabalho em equipe de um usuário. |
| Atualizar | Trabalho em equipeSeção | Atualizar as propriedades de uma seção no trabalho em equipe de um usuário. |
| Delete | Nenhum | Excluir uma seção definida pelo usuário do trabalho em equipe de um usuário. |
| Itens de lista | coleção teamworkSectionItem | Obtenha a lista de itens em uma seção do trabalho em equipe de um usuário. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| createdDateTime | DateTimeOffset | Data e hora em que a seção foi criada. Somente leitura. O tipo de carimbo de data/hora representa informações de data e hora usando o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC em 1º de janeiro de 2024 é 2024-01-01T00:00:00Z. |
| displayIcon | sectionDisplayIcon | O ícone exibido para a seção. |
| displayName | Cadeia de caracteres | O nome de exibição da seção. Obrigatório. O comprimento máximo é de 50 caracteres. Os nomes de exibição diferenciam maiúsculas de minúsculas e devem ser exclusivos nas seções de um usuário. Os nomes a seguir são reservados para seções definidas pelo sistema e não podem ser usados ao criar uma seção definida pelo usuário: RecentChats, QuickViews, TeamsAndChannels, MeetingChatsMutedChatsEngageCommunities, , . |
| id | Cadeia de caracteres | O identificador exclusivo da seção. Somente leitura. |
| é expandido | Booliano | Indica se a seção é expandida na interface do usuário. O valor padrão é true. |
| isHierarchicalViewEnabled | Booliano | Indica se a exibição hierárquica está habilitada para a seção. Somente leitura. |
| lastModifiedDateTime | DateTimeOffset | Data e hora em que a seção foi modificada pela última vez. Somente leitura. O tipo de carimbo de data/hora representa informações de data e hora usando o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC em 1º de janeiro de 2024 é 2024-01-01T00:00:00Z. |
| sectionType | sectionType | O tipo da seção. Os valores possíveis são: userDefined, systemDefined, unknownFutureValue. Somente leitura. |
| sortType | sectionSortType | A ordem de classificação dos itens na seção. Os valores válidos dependem do sectionType. Os valores possíveis são: mostRecent, unreadThenMostRecent, nameAlphabetical, userDefinedCustomOrder, unknownFutureValue. |
valores sectionType
| Member | Descrição |
|---|---|
| userDefined | Uma seção criada pelo usuário que pode ser renomeada, reordenada e excluída. |
| definido pelo sistema | Uma seção gerenciada pelo serviço que não pode ser excluída. Somente a propriedade sortType pode ser atualizada. |
| unknownFutureValue | Valor sentinela de enumeração evolutiva. Não usar. |
Seções definidas pelo sistema
As seções definidas pelo sistema são provisionadas pelo serviço e aparecem na lista de seções de cada usuário. Seus valores displayName são reservados e não podem ser usados para seções definidas pelo usuário.
| displayName | Descrição |
|---|---|
| RecentChats | A seção de chats padrão. |
| Exibições rápidas | A seção Visualizações rápidas. |
| TeamsAndChannels | A seção equipes e canais. |
| Chats Silenciados | A seção de chats silenciados. |
| MeetingChats | A seção de chats da reunião. |
| Comunidades Engajadas | A seção de comunidades. |
As seções definidas pelo sistema não podem ser excluídas e somente a propriedade sortType pode ser atualizada. Tentativas de atualizar outras propriedades ou excluir um retorno 403 Forbiddende seção definido pelo sistema. Não há suporte para a listagem de itens em uma seção definida pelo sistema chamando Não há suporte para itens da lista e retorna .400 Bad Request Quando List sections ou Get teamworkSection é chamado com ?$expand=items, as seções definidas pelo sistema são retornadas com uma matriz de itens vazios porque o conteúdo da seção definida pelo sistema não é exposto por meio da API do Graph pública.
valores sectionSortType
| Member | Descrição |
|---|---|
| mostRecent | Classifique os itens por atividade mais recente. Válido para seções definidas pelo usuário e a maioria das seções definidas pelo sistema. |
| unreadThenMostRecent | Classifique os itens não lidos primeiro e, em seguida, pela atividade mais recente. Válido para seções definidas pelo usuário e a maioria das seções definidas pelo sistema. |
| nameAlphabetical | Classifique itens em ordem alfabética por nome. Válido somente para seções específicas definidas pelo sistema, como Equipes e Canais. Não é válido para seções definidas pelo usuário. |
| userDefinedCustomOrder | Classifique itens de acordo com uma ordem personalizada definida pelo usuário. Válido somente para seções definidas pelo usuário. Esse é o tipo de classificação padrão para novas seções definidas pelo usuário. |
| unknownFutureValue | Valor sentinela de enumeração evolutiva. Não usar. |
Observação
Os tipos de classificação válidos para seções definidas pelo sistema dependem da seção específica. Por exemplo, as seções Teams e Canais dão suporte a nameAlphabetical, mas as seções RecentChats e MutedChats dão suporte apenas mostRecent a .unreadThenMostRecent Quando a propriedade isHierarchicalViewEnabled é definida como true para uma seção de Equipes e Canais , somente nameAlphabetical é válido. A configuração de um tipo de classificação sem suporte retorna um 400 Bad Request erro.
Atributos de instância
Atributos de instância são propriedades com comportamentos especiais. Essas propriedades são temporárias e a) definem o comportamento que o serviço deve apresentar ou b) fornecem valores de propriedades de curto prazo, como uma URL de download, para um item com data de expiração.
| Nome da propriedade | Tipo | Descrição |
|---|---|---|
| @microsoft.graph.sectionsOrder | String collection | Uma matriz ordenada de IDs de seção que representam a ordem de seção preferida do usuário. |
| @microsoft.graph.sectionsVersion | Cadeia de caracteres | A versão atual da hierarquia de seções. Use esse valor como o cabeçalho para o If-Match controle de simultaneidade otimista em operações de mutação (criar, atualizar ou excluir seções e adicionar, remover ou mover itens). |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| items | coleção teamworkSectionItem | Os itens (chats, canais, reuniões ou comunidades) organizados dentro da seção. |
Representação JSON
A representação JSON a seguir mostra o tipo de recurso.
{
"@odata.type": "#microsoft.graph.teamworkSection",
"createdDateTime": "String (timestamp)",
"displayIcon": {"@odata.type": "microsoft.graph.sectionDisplayIcon"},
"displayName": "String",
"id": "String (identifier)",
"isExpanded": "Boolean",
"isHierarchicalViewEnabled": "Boolean",
"lastModifiedDateTime": "String (timestamp)",
"sectionType": "String",
"sortType": "String"
}