tipo de recurso teamworkSection

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.

Representa una sección de la lista de chats de Microsoft Teams de un usuario que organiza chats, canales y reuniones en grupos personalizados o definidos por el sistema. Las secciones se pueden definir por el usuario, lo que permite a los usuarios crearlas, cambiarlas de nombre y eliminarlas, o definidas por el sistema, que administra el servicio.

Métodos

Método Tipo devuelto Descripción
List colección teamworkSection Obtenga la lista de secciones del trabajo en equipo de un usuario.
Crear teamworkSection Cree una nueva sección en el trabajo en equipo de un usuario.
Get teamworkSection Lea las propiedades de una sección del trabajo en equipo de un usuario.
Actualizar teamworkSection Actualice las propiedades de una sección del trabajo en equipo de un usuario.
Delete Ninguno Elimine una sección definida por el usuario del trabajo en equipo de un usuario.
Elementos de lista colección teamworkSectionItem Obtenga la lista de elementos de una sección del trabajo en equipo de un usuario.

Propiedades

Propiedad Tipo Descripción
createdDateTime DateTimeOffset Fecha y hora en que se creó la sección. Solo lectura. El tipo de marca de tiempo representa la información de fecha y hora mediante el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche UTC del 1 de enero de 2024 es 2024-01-01T00:00:00Z.
displayIcon sectionDisplayIcon Icono que se muestra para la sección.
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 al crear una sección definida por el usuario: RecentChats, QuickViews, TeamsAndChannels, MutedChats, MeetingChats, EngageCommunities.
id Cadena Identificador único de la sección. Solo lectura.
isExpanded Booleano Indica si la sección se expande en la interfaz de usuario. El valor predeterminado es true.
isHierarchicalViewEnabled Booleano Indica si la vista jerárquica está habilitada para la sección. Solo lectura.
lastModifiedDateTime DateTimeOffset Fecha y hora en que se modificó por última vez la sección. Solo lectura. El tipo de marca de tiempo representa la información de fecha y hora mediante el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche UTC del 1 de enero de 2024 es 2024-01-01T00:00:00Z.
sectionType sectionType Tipo de la sección. Los valores posibles son: userDefined, systemDefined, unknownFutureValue. Solo lectura.
sortType sectionSortType Criterio de ordenación de los elementos de la sección. Los valores válidos dependen de sectionType. Los valores posibles son: mostRecent, unreadThenMostRecent, nameAlphabetical, userDefinedCustomOrder, unknownFutureValue.

valores sectionType

Member Descripción
userDefined Sección creada por el usuario que se puede cambiar de nombre, reordenar y eliminar.
systemDefined Sección administrada por el servicio que no se puede eliminar. Solo se puede actualizar la propiedad sortType .
unknownFutureValue Valor de sentinel de enumeración evolvable. No usar.

Secciones definidas por el sistema

El servicio aprovisiona las secciones definidas por el sistema y aparecen en la lista de secciones de cada usuario. Sus valores displayName están reservados y no se pueden usar para las secciones definidas por el usuario.

displayName Description
RecentChats Sección de chats predeterminada.
Vistas rápidas La sección Vistas rápidas.
TeamsAndChannels Sección de equipos y canales.
MutedChats Sección de chats silenciados.
MeetingChats Sección de chats de reunión.
EngageCommunities Sección comunidades.

Las secciones definidas por el sistema no se pueden eliminar y solo se puede actualizar la propiedad sortType . Los intentos de actualizar otras propiedades o eliminar una sección definida por el sistema devuelven 403 Forbidden. No se admite la enumeración de elementos en una sección definida por el sistema y devuelve 400 Bad Request.

sectionSortType values

Member Descripción
mostRecent Ordene los elementos por la actividad más reciente. Válido para las secciones definidas por el usuario y la mayoría definidas por el sistema.
unreadThenMostRecent Ordene primero los elementos no leídos y, a continuación, por la actividad más reciente. Válido para las secciones definidas por el usuario y la mayoría definidas por el sistema.
nameAlphabetical Ordenar los elementos alfabéticamente por nombre. Válido solo para secciones específicas definidas por el sistema, como Teams y Canales. No es válido para las secciones definidas por el usuario.
userDefinedCustomOrder Ordenar elementos según un orden personalizado definido por el usuario. Válido solo para secciones definidas por el usuario. Este es el tipo de ordenación predeterminado para las nuevas secciones definidas por el usuario.
unknownFutureValue Valor de sentinel de enumeración evolvable. No usar.

Nota:

Los tipos de ordenación válidos para las secciones definidas por el sistema dependen de la sección específica. Por ejemplo, las secciones Teams y Canales admiten nameAlphabetical, pero las secciones RecentChats y MutedChats solo mostRecent admiten y unreadThenMostRecent. Cuando la propiedad isHierarchicalViewEnabled está establecida en true para una sección Teams y Channels , solo nameAlphabetical es válida. Al establecer un tipo de ordenación no admitido, se devuelve un 400 Bad Request error.

Atributos de instancia

Los atributos de instancia son propiedades con comportamientos especiales. Estas propiedades son temporales y o bien a) definen el comportamiento que debería tener el servicio o b) proporcionan valores de propiedad a corto plazo, como una dirección URL de descarga de un elemento que expira.

Nombre de propiedad Tipo Description
@microsoft.graph.sectionsOrder Colección string Matriz ordenada de identificadores de sección que representan el orden de sección preferido del usuario.
@microsoft.graph.sectionsVersion Cadena La versión actual de la jerarquía de sección. Use este valor como encabezado para el If-Match control de simultaneidad optimista en las operaciones de mutación (crear, actualizar o eliminar secciones y agregar, quitar o mover elementos).

Relaciones

Relación Tipo Descripción
items colección teamworkSectionItem Los elementos (chats, canales, reuniones o comunidades) organizados dentro de la sección.

Representación JSON

La siguiente representación JSON muestra el 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"
}

Contenido relacionado

  • Last updated on