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.
Crie uma nova secção no trabalho de equipa de um utilizador.
Esta API está disponível nas seguintes implementações de cloud nacionais.
| Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Permissões
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
| Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | TeamworkSection.ReadWrite | Indisponível. |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | TeamworkSection.ReadWrite.All | Teamwork.Migrate.All |
Solicitação HTTP
POST /users/{user-id}/teamwork/sections
Cabeçalhos de solicitação
| Cabeçalho | Valor |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| Content-Type | application/json. Obrigatório. |
| If-Match | O valor da anotação @microsoft.graph.sectionsVersion devolvido quando lista secções ou o valor @odata.etag de qualquer secção obtida anteriormente. Necessário para o controlo de simultaneidade otimista. |
Corpo da solicitação
No corpo do pedido, forneça uma representação JSON de um objeto teamworkSection .
A tabela seguinte lista as propriedades que pode definir quando cria uma teamworkSection.
| Propriedade | Tipo | Descrição |
|---|---|---|
| displayIcon | sectionDisplayIcon | O ícone apresentado para a secção. Opcional. A propriedade skinTone do ícone não pode ser definida e deriva das definições do utilizador. |
| 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: RecentChats, QuickViews, TeamsAndChannels, MutedChats, MeetingChats, . EngageCommunities |
| isExpanded | Booliano | Indica se a secção está expandida na interface de utilizador. Opcional. O valor padrão é true. |
| sortType | sectionSortType | A sequência de ordenação dos itens na secção . Opcional. O valor padrão é userDefinedCustomOrder. Os valores válidos para secções definidas pelo utilizador são: mostRecent, unreadThenMostRecent, , userDefinedCustomOrder. unknownFutureValue O nameAlphabetical membro não é válido para secções definidas pelo utilizador. |
Resposta
Se for bem-sucedido, este método devolve um 201 Created código de resposta e um objeto teamworkSection no corpo da resposta.
Observação
A resposta inclui um valor @odata.etag atualizado. Utilize este valor como cabeçalho If-Match para quaisquer operações de mutação subsequentes.
Os seguintes erros são possíveis.
| Código da resposta | Mensagem |
|---|---|
400 Bad Request |
A propriedade "displayName" é necessária e não pode estar vazia. |
400 Bad Request |
A propriedade "displayName" não pode exceder os 50 carateres. |
400 Bad Request |
O nome a apresentar da secção contém carateres ou formato inválidos. |
400 Bad Request |
A propriedade "id", "createdDateTime", "lastModifiedDateTime", "sectionType" ou "isHierarchicalViewEnabled" é só de leitura e não pode ser fornecida ao criar uma secção. |
400 Bad Request |
A propriedade "displayIcon.contentUrl" não é suportada ou a propriedade "displayIcon.displayName" ou "displayIcon.skinTone" é só de leitura e não pode ser fornecida. |
400 Bad Request |
O número máximo de secções foi atingido. |
409 Conflict |
Já existe uma secção com este nome a apresentar. Devolvido quando o displayName pedido corresponde a uma secção definida pelo utilizador existente ou a um dos nomes de secção reservados definidos pelo sistema (RecentChats, , QuickViewsTeamsAndChannels, MutedChats, MeetingChats, EngageCommunities). A comparação é sensível às maiúsculas e minúsculas. |
412 Precondition Failed |
O If-Match valor do cabeçalho não corresponde à versão atual da hierarquia de secções.
Liste novamente secções para obter o @microsoft.graph.sectionsEstação de versão atual e repetição. |
428 Precondition Required |
O If-Match cabeçalho é necessário para esta operação. |
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
POST https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections
Content-type: application/json
If-Match: "1742515200"
{
"displayName": "Project Alpha",
"displayIcon": {
"iconType": "🚀"
},
"sortType": "mostRecent"
}
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 201 Created
Content-type: application/json
Location: https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections/c3d4e5f6-a7b8-9012-cdef-123456789012
{
"@odata.type": "#microsoft.graph.teamworkSection",
"@odata.etag": "\"1742515210\"",
"id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"displayName": "Project Alpha",
"displayIcon": {
"iconType": "🚀",
"displayName": "Rocket",
"contentUrl": null,
"skinTone": null
},
"sectionType": "userDefined",
"sortType": "mostRecent",
"isExpanded": true,
"isHierarchicalViewEnabled": false,
"createdDateTime": "2026-03-08T10:00:00Z",
"lastModifiedDateTime": "2026-03-08T10:00:00Z"
}