Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Cree una nueva sección en el trabajo en equipo de un usuario.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
| Tipo de permiso | Permisos con privilegios mínimos | Permisos con privilegios más altos |
|---|---|---|
| Delegado (cuenta profesional o educativa) | TeamworkSection.ReadWrite | No disponible. |
| Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
| Aplicación | TeamworkSection.ReadWrite.All | No disponible. |
Solicitud HTTP
POST /users/{user-id}/teamwork/sections
Encabezados de solicitud
| Encabezado | Valor |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
| Content-Type | application/json. Obligatorio. |
| If-Match | Valor de la anotación @microsoft.graph.sectionsVersion devuelta al enumerar secciones o el valor @odata.etag de cualquier sección recuperada anteriormente. Necesario para el control de simultaneidad optimista. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione una representación JSON de un objeto teamworkSection .
En la tabla siguiente se enumeran las propiedades que puede establecer al crear un teamworkSection.
| Propiedad | Tipo | Description |
|---|---|---|
| displayIcon | sectionDisplayIcon | Icono que se muestra para la sección. Opcional. La propiedad skinTone del icono no se puede establecer y se deriva de la configuración del usuario. |
| displayName | Cadena | Nombre para mostrar de la sección. Obligatorio. La longitud máxima es de 50 caracteres. Los nombres para mostrar distinguen mayúsculas de minúsculas y deben ser únicos dentro de las secciones de un usuario. Los siguientes nombres están reservados para secciones definidas por el sistema y no se pueden usar: RecentChats, QuickViews, TeamsAndChannels, MutedChats, MeetingChats, EngageCommunities. |
| isExpanded | Booleano | Indica si la sección se expande en la interfaz de usuario. Opcional. El valor predeterminado es true. |
| sortType | sectionSortType | Criterio de ordenación de los elementos de la sección. Opcional. El valor predeterminado es userDefinedCustomOrder. Los valores válidos para las secciones definidas por el usuario son: mostRecent, unreadThenMostRecent, userDefinedCustomOrder, unknownFutureValue. El nameAlphabetical miembro no es válido para las secciones definidas por el usuario. |
Respuesta
Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto teamworkSection en el cuerpo de la respuesta.
Nota:
La respuesta incluye un valor de @odata.etag actualizado. Use este valor como If-Match encabezado para cualquier operación de mutación posterior.
Los siguientes errores son posibles.
| Código de respuesta | Mensaje |
|---|---|
400 Bad Request |
La propiedad "displayName" es obligatoria y no debe estar vacía. |
400 Bad Request |
La propiedad "displayName" no debe superar los 50 caracteres. |
400 Bad Request |
El nombre para mostrar de la sección contiene caracteres o formato no válidos. |
400 Bad Request |
La propiedad 'id', 'createdDateTime', 'lastModifiedDateTime', 'sectionType' o 'isHierarchicalViewEnabled' es de solo lectura y no se debe proporcionar al crear una sección. |
400 Bad Request |
No se admite la propiedad "displayIcon.contentUrl" o la propiedad "displayIcon.displayName" o "displayIcon.skinTone" es de solo lectura y no se debe proporcionar. |
400 Bad Request |
Se ha alcanzado el número máximo de secciones. |
409 Conflict |
Ya existe una sección con este nombre para mostrar. Se devuelve cuando el displayName solicitado coincide con una sección definida por el usuario existente o con uno de los nombres de sección reservados definidos por el sistema (RecentChats, QuickViews, TeamsAndChannels, MutedChats, MeetingChats, EngageCommunities). La comparación distingue mayúsculas de minúsculas. |
412 Precondition Failed |
El If-Match valor de encabezado no coincide con la versión actual de la jerarquía de sección. Vuelva a enumerar las secciones para recuperar la anotación y reintento de @microsoft.graph.sectionsVersion actual. |
428 Precondition Required |
El If-Match encabezado es necesario para esta operación. |
Ejemplos
Solicitud
En el ejemplo siguiente se muestra la solicitud.
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"
}
Respuesta
En el ejemplo siguiente se muestra la respuesta.
Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.
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"
}