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 secção na lista de chat do Microsoft Teams de um utilizador que organiza conversas, canais e reuniões em grupos personalizados ou definidos pelo sistema. As secções podem ser definidas pelo utilizador, permitindo aos utilizadores criar, mudar o nome e eliminá-las ou definidas pelo sistema, que são geridas pelo serviço.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| List | teamworkSection collection | Obtenha a lista de secções no trabalho de equipa de um utilizador. |
| Create | teamworkSection | Crie uma nova secção no trabalho de equipa de um utilizador. |
| Get | teamworkSection | Leia as propriedades de uma secção no trabalho de equipa de um utilizador. |
| Atualizar | teamworkSection | Atualize as propriedades de uma secção no trabalho de equipa de um utilizador. |
| Delete | Nenhum | Eliminar uma secção definida pelo utilizador do trabalho de equipa de um utilizador. |
| Itens de lista | teamworkSectionItem collection | Obtenha a lista de itens numa secção do trabalho de equipa de um utilizador. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| createdDateTime | DateTimeOffset | Data e hora em que a secção foi criada. Somente leitura. O tipo de carimbo de data/hora representa informações de data e hora com o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC a 1 de janeiro de 2024 é 2024-01-01T00:00:00Z. |
| displayIcon | sectionDisplayIcon | O ícone apresentado para a secção. |
| displayName | Cadeia de caracteres | O nome a apresentar da secção. Obrigatório. O comprimento máximo é de 50 carateres. Os nomes a apresentar são sensíveis às maiúsculas e minúsculas e têm de ser exclusivos nas secções de um utilizador. Os seguintes nomes estão reservados para secções definidas pelo sistema e não podem ser utilizados ao criar uma secção definida pelo utilizador: RecentChats, , TeamsAndChannelsQuickViews, MutedChats, MeetingChats, EngageCommunities. |
| id | Cadeia de caracteres | O identificador exclusivo da secção. Somente leitura. |
| isExpanded | Booliano | Indica se a secção está expandida na interface de utilizador. O valor padrão é true. |
| isHierarchicalViewEnabled | Booliano | Indica se a vista hierárquica está ativada para a secção. Somente leitura. |
| lastModifiedDateTime | DateTimeOffset | Data e hora em que a secção foi modificada pela última vez. Somente leitura. O tipo de carimbo de data/hora representa informações de data e hora com o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC a 1 de janeiro de 2024 é 2024-01-01T00:00:00Z. |
| sectionType | sectionType | O tipo da secção. Os valores possíveis são: userDefined, systemDefined, unknownFutureValue. Somente leitura. |
| sortType | sectionSortType | A sequência de ordenação dos itens na secçã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 secção criada pelo utilizador que pode ser renomeada, reordenada e eliminada. |
| systemDefined | Uma secção gerida pelo serviço que não pode ser eliminada. Apenas a propriedade sortType pode ser atualizada. |
| unknownFutureValue | Valor da sentinela de enumeração evoluível. Não usar. |
Secções definidas pelo sistema
As secções definidas pelo sistema são aprovisionadas pelo serviço e aparecem na lista de secções de todos os utilizadores. Os respetivos valores displayName são reservados e não podem ser utilizados para secções definidas pelo utilizador.
| displayName | Descrição |
|---|---|
| Conversas Recentes | A secção conversas predefinidas. |
| QuickViews | A secção Vistas rápidas. |
| TeamsAndChannels | A secção equipas e canais. |
| MutedChats | A secção chats sem som. |
| MeetingChats | A secção chats da reunião. |
| Interagir com as Comunas | A secção de comunidades. |
As secções definidas pelo sistema não podem ser eliminadas e apenas a propriedade sortType pode ser atualizada. Tenta atualizar outras propriedades ou eliminar uma devolução de secção 403 Forbiddendefinida pelo sistema. A listagem de itens numa secção definida pelo sistema não é suportada e devolve 400 Bad Request.
sectionSortType values (valores sectionSortType)
| Member | Descrição |
|---|---|
| mostRecent | Ordene itens pela atividade mais recente. Válido para as secções definidas pelo utilizador e mais definidas pelo sistema. |
| unreadThenMostRecent | Ordene primeiro itens não lidos e, em seguida, por atividade mais recente. Válido para as secções definidas pelo utilizador e mais definidas pelo sistema. |
| nameAlphabetical | Ordene os itens alfabeticamente por nome. Válido apenas para secções específicas definidas pelo sistema, como Equipas e Canais. Não é válido para secções definidas pelo utilizador. |
| userDefinedCustomOrder | Ordene itens de acordo com uma ordem personalizada definida pelo utilizador. Válido apenas para secções definidas pelo utilizador. Este é o tipo de ordenação predefinido para novas secções definidas pelo utilizador. |
| unknownFutureValue | Valor da sentinela de enumeração evoluível. Não usar. |
Observação
Os tipos de ordenação válidos para secções definidas pelo sistema dependem da secção específica. Por exemplo, as secções Teams e Channels suportam nameAlphabetical, mas as secções RecentChats e MutedChats suportam apenas mostRecent e unreadThenMostRecent. Quando a propriedade éHierarchicalViewEnabled está definida como true para uma secção Teams e Canais , apenas nameAlphabetical é válida. Definir um tipo de ordenação não suportado devolve 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 secção que representam a ordem de secção preferencial do utilizador. |
| @microsoft.graph.sectionsVersion | Cadeia de caracteres | A versão atual da hierarquia de secções. Utilize este valor como cabeçalho para o If-Match controlo de simultaneidade otimista nas operações de mutação (criar, atualizar ou eliminar secções e adicionar, remover ou mover itens). |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| items | teamworkSectionItem collection | Os itens (conversas, canais, reuniões ou comunidades) organizados na secção. |
Representação JSON
A representação JSON seguinte 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"
}