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 ao chamar Itens de lista não é suportada e devolve 400 Bad Request. Quando as secções Lista ou Obter trabalho de equipaSecção são chamadas com ?$expand=items, as secções definidas pelo sistema são devolvidas com uma matriz de itens vazia porque os conteúdos de secção definidos pelo sistema não são expostos através da API do Graph pública.
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"
}