Criar trabalho em equipeSection

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.

Criar uma nova seção no trabalho em equipe de um usuário.

Essa API está disponível nas seguintes implantações de nuvem nacional.

Serviço global	Governo dos EUA L4	US Government L5 (DOD)	China operada pela 21Vianet
✅	❌	❌	❌

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão	Permissões menos privilegiadas	Permissões com privilégios mais elevados
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 retornado quando você lista seções ou o valor @odata.etag de qualquer seção recuperada anteriormente. Necessário para controle de simultaneidade otimista.

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON de um objeto teamworkSection .

A tabela a seguir lista as propriedades que você pode definir ao criar um teamworkSection.

Propriedade	Tipo	Descrição
displayIcon	sectionDisplayIcon	O ícone exibido para a seção. Opcional. A propriedade skinTone do ícone não pode ser definida e é derivada das configurações do usuário.
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: `RecentChats`, `QuickViews`, `TeamsAndChannels`, `MutedChats`, `MeetingChats`, , `EngageCommunities`.
é expandido	Booliano	Indica se a seção é expandida na interface do usuário. Opcional. O valor padrão é `true`.
sortType	sectionSortType	A ordem de classificação dos itens na seção. Opcional. O valor padrão é `userDefinedCustomOrder`. Os valores válidos para as seções definidas pelo usuário são: `mostRecent`, `unreadThenMostRecent`, `userDefinedCustomOrder`, `unknownFutureValue`. O `nameAlphabetical` membro não é válido para seções definidas pelo usuário.

Resposta

Se for bem-sucedido, esse método retornará um código de 201 Created resposta e um objeto teamworkSection no corpo da resposta.

Observação

A resposta inclui um valor @odata.etag atualizado. Use esse valor como o If-Match cabeçalho para todas as operações de mutação subsequentes.

Os erros a seguir são possíveis.

Código da resposta	Mensagem
`400 Bad Request`	A propriedade 'displayName' é obrigatória e não deve estar vazia.
`400 Bad Request`	A propriedade 'displayName' não deve exceder 50 caracteres.
`400 Bad Request`	O nome de exibição da seção contém caracteres ou formato inválidos.
`400 Bad Request`	As propriedades 'id', 'createdDateTime', 'lastModifiedDateTime', 'sectionType' ou 'isHierarchicalViewEnabled' são somente leitura e não devem ser fornecidas ao criar uma seção.
`400 Bad Request`	A propriedade "displayIcon.contentUrl" não é suportada ou a propriedade "displayIcon.displayName" ou "displayIcon.skinTone" é somente leitura e não deve ser fornecida.
`400 Bad Request`	O número máximo de seções foi atingido.
`409 Conflict`	Já existe uma seção com este nome de exibição. Retornado quando o displayName solicitado corresponde a uma seção definida pelo usuário existente ou a um dos nomes de seção reservados definidos pelo sistema (`RecentChats`, `QuickViews`, `TeamsAndChannels`, `MutedChats`, `MeetingChats`, , `EngageCommunities`). A comparação diferencia maiúsculas de minúsculas.
`412 Precondition Failed`	O `If-Match` valor do cabeçalho não corresponde à versão atual da hierarquia de seção. Liste as seções novamente para recuperar a anotação atual @microsoft.graph.sectionsVersion e tente novamente.
`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"
}


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Beta.Models;

var requestBody = new TeamworkSection
{
	DisplayName = "Project Alpha",
	DisplayIcon = new SectionDisplayIcon
	{
		IconType = "🚀",
	},
	SortType = SectionSortType.MostRecent,
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Users["{user-id}"].Teamwork.Sections.PostAsync(requestBody, (requestConfiguration) =>
{
	requestConfiguration.Headers.Add("If-Match", "\"1742515200\"");
});

Importante

Os SDKs do Microsoft Graph usam a versão v1.0 da API por padrão e não oferecem suporte a todos os tipos, propriedades e APIs disponíveis na versão beta. Para obter detalhes sobre como acessar a API beta com o SDK, consulte Usar os SDKs do Microsoft Graph com a API beta.

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.



// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  abstractions "github.com/microsoft/kiota-abstractions-go"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
	  graphusers "github.com/microsoftgraph/msgraph-beta-sdk-go/users"
	  //other-imports
)

headers := abstractions.NewRequestHeaders()
headers.Add("If-Match", "\"1742515200\"")

configuration := &graphusers.ItemTeamworkSectionsRequestBuilderPostRequestConfiguration{
	Headers: headers,
}
requestBody := graphmodels.NewTeamworkSection()
displayName := "Project Alpha"
requestBody.SetDisplayName(&displayName) 
displayIcon := graphmodels.NewSectionDisplayIcon()
iconType := "🚀"
displayIcon.SetIconType(&iconType) 
requestBody.SetDisplayIcon(displayIcon)
sortType := graphmodels.MOSTRECENT_SECTIONSORTTYPE 
requestBody.SetSortType(&sortType) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
sections, err := graphClient.Users().ByUserId("user-id").Teamwork().Sections().Post(context.Background(), requestBody, configuration)

Importante

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

TeamworkSection teamworkSection = new TeamworkSection();
teamworkSection.setDisplayName("Project Alpha");
SectionDisplayIcon displayIcon = new SectionDisplayIcon();
displayIcon.setIconType("🚀");
teamworkSection.setDisplayIcon(displayIcon);
teamworkSection.setSortType(SectionSortType.MostRecent);
TeamworkSection result = graphClient.users().byUserId("{user-id}").teamwork().sections().post(teamworkSection, requestConfiguration -> {
	requestConfiguration.headers.add("If-Match", "\"1742515200\"");
});

Importante

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.


const options = {
	authProvider,
};

const client = Client.init(options);

const teamworkSection = {
  displayName: 'Project Alpha',
  displayIcon: {
    iconType: '🚀'
  },
  sortType: 'mostRecent'
};

await client.api('/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections')
	.version('beta')
	.post(teamworkSection);

Importante

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.


<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Users\Item\Teamwork\Sections\SectionsRequestBuilderPostRequestConfiguration;
use Microsoft\Graph\Beta\Generated\Models\TeamworkSection;
use Microsoft\Graph\Beta\Generated\Models\SectionDisplayIcon;
use Microsoft\Graph\Beta\Generated\Models\SectionSortType;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new TeamworkSection();
$requestBody->setDisplayName('Project Alpha');
$displayIcon = new SectionDisplayIcon();
$displayIcon->setIconType('🚀');
$requestBody->setDisplayIcon($displayIcon);
$requestBody->setSortType(new SectionSortType('mostRecent'));
$requestConfiguration = new SectionsRequestBuilderPostRequestConfiguration();
$headers = [
		'If-Match' => '"1742515200"',
	];
$requestConfiguration->headers = $headers;


$result = $graphServiceClient->users()->byUserId('user-id')->teamwork()->sections()->post($requestBody, $requestConfiguration)->wait();

Importante

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.


Import-Module Microsoft.Graph.Beta.Teams

$params = @{
	displayName = "Project Alpha"
	displayIcon = @{
		iconType = "🚀"
	}
	sortType = "mostRecent"
}

New-MgBetaUserTeamworkSection -UserId $userId -BodyParameter $params

Importante

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.users.item.teamwork.sections.sections_request_builder import SectionsRequestBuilder
from kiota_abstractions.base_request_configuration import RequestConfiguration
from msgraph_beta.generated.models.teamwork_section import TeamworkSection
from msgraph_beta.generated.models.section_display_icon import SectionDisplayIcon
from msgraph_beta.generated.models.section_sort_type import SectionSortType
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = TeamworkSection(
	display_name = "Project Alpha",
	display_icon = SectionDisplayIcon(
		icon_type = "🚀",
	),
	sort_type = SectionSortType.MostRecent,
)

request_configuration = RequestConfiguration()
request_configuration.headers.add("If-Match", "\"1742515200\"")


result = await graph_client.users.by_user_id('user-id').teamwork.sections.post(request_body, request_configuration = request_configuration)

Importante

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

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"
}

Comentários

Esta página foi útil?

Last updated on 2026-08-18

Criar trabalho em equipeSection

Permissões

Solicitação HTTP

Cabeçalhos de solicitação

Corpo da solicitação

Resposta

Exemplos

Solicitação

Resposta

Comentários

Recursos adicionais