Agregar teamworkSectionItem

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.

Agregue un elemento, como un chat, un canal, una reunión o una comunidad, a una sección definida por el usuario en el trabajo en equipo de un usuario. Un elemento solo puede pertenecer a una sección a la vez. Si el elemento está en una sección diferente definida por el usuario, esta solicitud lo mueve a la sección de destino. Si el elemento ya está en la sección de destino, la solicitud se realiza correctamente sin realizar cambios.

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ❌ ❌ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos 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 Teamwork.Migrate.All

Solicitud HTTP

POST /users/{user-id}/teamwork/sections/{teamworkSection-id}/items

Encabezados de solicitud

Encabezado Valor
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON de un objeto teamworkSectionItem .

En la tabla siguiente se enumeran las propiedades que puede establecer al agregar un teamworkSectionItem.

Propiedad Tipo Descripción
id Cadena El id. de conversación del chat, canal, reunión o comunidad que se va a agregar a la sección. Para un elemento de comunidad (Viva Engage), puede proporcionar el identificador de comunidad desnudo devuelto al enumerar comunidades (por ejemplo, eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxOTAzMzYyMTIyMTAifQ) o el identificador de subproceso completo19:{communityId}@EngageCommunity. Cuando se proporciona un identificador de comunidad básico, el servicio lo normaliza automáticamente al 19:{communityId}@EngageCommunity formato; un identificador que ya incluye el prefijo de subproceso se usa tal cual. Obligatorio.

Respuesta

Si tiene éxito, este método devuelve un 201 Created código de respuesta y un objeto teamworkSectionItem en el cuerpo de la respuesta.

Es posible que se produzcan los siguientes errores.

Código de respuesta Mensaje
400 Bad Request La propiedad "id" es obligatoria y no debe estar vacía.
400 Bad Request El id. de elemento especificado no es válido. Proporcione un identificador válido de chat, canal, reunión o comunidad.
400 Bad Request Se ha alcanzado el número máximo de elementos de esta sección.
403 Forbidden Se deniega el acceso a este recurso. El autor de la llamada debe ser un miembro de la conversación que se agrega.
404 Not Found No se encontró la sección especificada.
409 Conflict La sección no se puede actualizar debido a un cambio simultáneo. Vuelva a intentar realizar la solicitud.

Ejemplos

Ejemplo 1: Agregar un chat a una sección

En el ejemplo siguiente se muestra cómo agregar un chat a una sección.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections/a1b2c3d4-e5f6-7890-abcd-ef1234567890/items
Content-type: application/json

{
  "id": "19:d5b2c3a4-e6f7-8901-abcd-ef3456789012@thread.v2"
}

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/a1b2c3d4-e5f6-7890-abcd-ef1234567890/items/19:d5b2c3a4-e6f7-8901-abcd-ef3456789012@thread.v2

{
  "@odata.type": "#microsoft.graph.teamworkSectionItem",
  "@odata.etag": "\"1742515210\"",
  "id": "19:d5b2c3a4-e6f7-8901-abcd-ef3456789012@thread.v2",
  "itemType": "chat",
  "createdDateTime": "2026-03-08T10:00:00Z",
  "lastModifiedDateTime": null
}

Ejemplo 2: Agregar una comunidad a una sección

En el ejemplo siguiente se muestra cómo agregar una comunidad de Viva Engage a una sección. La solicitud proporciona el ID. de la comunidad desnudo devuelto cuando enumera las comunidades. El servicio normaliza el identificador de la comunidad al 19:{communityId}@EngageCommunity formato que se devuelve en la respuesta.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections/a1b2c3d4-e5f6-7890-abcd-ef1234567890/items
Content-type: application/json

{
  "id": "eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxOTAzMzYyMTIyMTAifQ"
}

Respuesta

En el ejemplo siguiente se muestra la respuesta. La propiedad id se devuelve en el formato normalizado 19:{communityId}@EngageCommunity .

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/a1b2c3d4-e5f6-7890-abcd-ef1234567890/items/19:eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxOTAzMzYyMTIyMTAifQ@EngageCommunity

{
  "@odata.type": "#microsoft.graph.teamworkSectionItem",
  "@odata.etag": "\"1742515220\"",
  "id": "19:eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxOTAzMzYyMTIyMTAifQ@EngageCommunity",
  "itemType": "community",
  "createdDateTime": "2026-03-08T10:05:00Z",
  "lastModifiedDateTime": null
}
  • Se actualizó por última vez el