Compartir a través de


tipo de recurso chat

Espacio de nombres: microsoft.graph

Un chat es una colección de chatMessages entre uno o varios participantes. Los participantes pueden ser usuarios o aplicaciones.

Nota: Si el chat está asociado a una instancia de onlineMeeting , algunos de los métodos enumerados afectarán transitivamente a la reunión.

Métodos

Método Tipo de valor devuelto Descripción
Administración de chats
Crear chat chat Cree un nuevo chat.
Obtener chat chat Lea las propiedades y las relaciones del chat.
Actualizar chat chat Actualice las propiedades del chat.
Delete Ninguno Eliminar un chat.
Enumerar los miembros Colección conversationmember Obtenga la lista de todos los usuarios del chat.
Agregar miembro Encabezado de ubicación Agregue un usuario al chat.
Obtener miembro conversationMember Obtenga un único usuario en el chat.
Eliminar miembro Ninguno Quite un usuario del chat.
Obtener chat entre el usuario y la aplicación chat Obtener chat uno a uno entre el usuario y la aplicación
Mensajes
Enumerar mensajes en un chat chatMessage Obtener mensajes en un chat.
Obtener la respuesta del mensaje chatMessage Obtener un único mensaje de un chat.
Obtención de mensajes en todos los chats colección de chats Obtener los mensajes de todos los chats en los que un usuario participa.
Obtener mensajes retenidos en todos los chats Colección chatMessage Obtenga todos los mensajes retenidos de todos los chats en los que un usuario es participante, incluidos los chats uno a uno, los chats grupales y los chats de reuniones.
Obtención de mensajes de chat delta para el usuario Colección chatMessage Obtenga la lista de mensajes de todos los chats en los que un usuario es participante, incluidos chats uno a uno, chats grupales y chats de reuniones.
Aplicaciones
Enumerar aplicaciones en el chat Colección teamsappinstallation Enumera las aplicaciones instaladas en un chat (y reunión asociada).
Instalar la aplicación en el chat teamsAppInstallation Obtener una aplicación específica instalada en un chat (y reunión asociada).
Agregar aplicación en el chat Agregue (instale) una aplicación en un chat (y una reunión asociada).
Actualizar aplicaciones instaladas en el chat Ninguno Actualice a la versión más reciente de la aplicación instalada en el chat (y la reunión asociada).
Eliminación de la aplicación del chat Ninguno Quite (desinstale) la aplicación de un chat (y la reunión asociada).
Enumerar concesiones de permisos Colección de resourceSpecificPermissionGrant Enumera los permisos concedidos a las aplicaciones de este chat.
Pestañas
Pestañas de lista en el chat teamsTab Mostrar pestañas ancladas a un chat (y reunión asociada).
Obtener pestaña en el chat teamsTab Obtener una pestaña específica anclada a un chat (y una reunión asociada).
Agregar pestaña al chat teamsTab Agregue (anclar) una pestaña a un chat (y una reunión asociada).
Pestaña Actualizar en el chat teamsTab Actualice las propiedades de una pestaña en un chat (y la reunión asociada).
Quitar pestaña del chat Ninguno Quite (desanclar) una pestaña de un chat (y una reunión asociada).
Mensajes anclados
Lista de mensajes anclados colección pinnedChatMessageInfo Obtenga una lista de mensajes anclados en un chat.
Anclar mensaje pinnedChatMessageInfo Anclar un mensaje de chat en un chat.
Desanclar mensaje Ninguno Desanclar un mensaje de un chat.

Nota: Al usar permisos de aplicación, asegúrese de que sabe cómo obtener el identificador de chat. Dado que no se admite la enumeración de chats con permisos de aplicación, no todos los escenarios son posibles. Es posible obtener identificadores de chat con permisos delegados y notificaciones de cambios para /chats/getAllMessages con permisos de aplicación.

Propiedades

Propiedad Tipo Descripción
chatType chatType Especifica el tipo de chat. Los valores posibles son: group, oneOnOne, meeting y unknownFutureValue.
createdDateTime dateTimeOffset Fecha y hora en que se creó el chat. Solo lectura.
id Cadena Identificador único del chat. Solo lectura.
lastUpdatedDateTime dateTimeOffset Fecha y hora a la que se cambió el nombre del chat o se cambió por última vez la lista de miembros. Solo lectura.
onlineMeetingInfo teamworkOnlineMeetingInfo Representa detalles sobre una reunión en línea. Si el chat no está asociado a una reunión en línea, la propiedad está vacía. Solo lectura.
tenantId Cadena Identificador del inquilino en el que se creó el chat. Solo lectura.
topic Cadena (Opcional) Asunto o tema para el chat. Solo está disponible para los chats de grupo.
punto de vista chatViewpoint Representa información específica del autor de la llamada sobre el chat, como la fecha y hora de lectura del último mensaje. Esta propiedad solo se rellena cuando la solicitud se realiza en un contexto delegado.
webUrl Cadena Dirección URL del chat en Microsoft Teams. La dirección URL debe tratarse como un blob opaco y no analizarse. Solo lectura.

valores chatType

Miembro Valor Descripción
oneOnOne 0 Indica que el chat es un chat 1:1. El tamaño de la lista se fija para este tipo de chat; los miembros no se pueden quitar ni agregar.
grupo 1 Indica que el chat es un chat de grupo. El tamaño de la lista (de al menos dos personas) se puede actualizar para este tipo de chat. Los miembros se pueden quitar o agregar más adelante.
reunión 2 Indica que el chat está asociado a una reunión en línea. Este tipo de chat solo se crea como parte de la creación de una reunión en línea.
unknownFutureValue 3 Valor de sentinel de enumeración evolvable. No usar.

Relaciones

Relación Tipo Description
installedApps Colección teamsappinstallation Colección de todas las aplicaciones del chat. Admite valores NULL.
lastMessagePreview chatMessageInfo Vista previa del último mensaje enviado en el chat. Null si no se envió ningún mensaje en el chat. Actualmente, solo la operación de chats de lista admite esta propiedad.
members Colección conversationmember Colección de todos los miembros del chat. Admite valores NULL.
messages Colección chatMessage Colección de todos los mensajes del chat. Admite un valor NULL.
permissionGrants Colección de resourceSpecificPermissionGrant Colección de permisos concedidos a las aplicaciones para el chat.
pinnedMessages colección pinnedChatMessageInfo Colección de todos los mensajes anclados en el chat. Admite un valor NULL.
pestañas Colección teamsTab Colección de todas las pestañas del chat. Admite valores NULL.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "createdDateTime": "dateTimeOffset",
  "chatType": "string",
  "id": "string (identifier)",
  "lastUpdatedDateTime": "dateTimeOffset",
  "onlineMeetingInfo": {
    "@odata.type": "microsoft.graph.teamworkOnlineMeetingInfo"
  },
  "tenantId": "string",
  "topic": "string",
  
  "viewpoint": {
    "@odata.type": "microsoft.graph.chatViewpoint"
  },
  "webUrl": "string",
}