chats: getAllMessageschats: getAllMessages

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Importante

Las API de la /beta versión de Microsoft Graph están sujetas a cambios.APIs under the /beta version in Microsoft Graph are subject to change. No se admite el uso de estas API en aplicaciones de producción.Use of these APIs in production applications is not supported. Para determinar si una API está disponible en v1.0, usa el selector de versiones.To determine whether an API is available in v1.0, use the Version selector.

Obtener todos los mensajes de todos los chats en los que un usuario participa, incluidos los chats individuales, los chats en grupo y los chats de reuniones.Get all messages from all chats that a user is a participant in, including one-on-one chats, group chats, and meeting chats.

PermisosPermissions

Se requieren los siguientes permisos para llamar a esta API.The following permissions are required to call this API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.To learn more, including how to choose permissions, see Permissions.

Tipo de permisoPermission type Permisos (de menos a más privilegiados)Permissions (from least to most privileged)
Delegado (cuenta profesional o educativa)Delegated (work or school account) No admitidoNot supported
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) No admitidoNot supported
AplicaciónApplication Chat.Read.All, Chat.ReadWrite.AllChat.Read.All, Chat.ReadWrite.All

Nota

Antes de llamar a esta API con permisos de aplicaciones, debe solicitar el acceso.Before calling this API with application permissions, you must request access. Para obtener más información, vea API protegidas en Microsoft Teams.For details, see Protected APIs in Microsoft Teams.

Solicitud HTTPHTTP request

GET /users/{id}/chats/getAllMessages

Parámetros de consulta opcionalesOptional query parameters

Esta operación admite parámetros de intervalo de fechas para personalizar la respuesta, tal como se muestra en el ejemplo siguiente.This operation supports date range parameters to customize the response, as shown in the following example.

GET /users/{id}/chats/getAllMessages?$top=50&$filter=lastModifiedDateTime gt 2020-06-04T18:03:11.591Z and lastModifiedDateTime lt 2020-06-05T21:00:09.413Z

Encabezados de solicitudRequest headers

EncabezadoHeader ValorValue
AuthorizationAuthorization {token} de portador. Obligatorio.Bearer {token}. Required.

RespuestaResponse

Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y una lista de chatMessages en el cuerpo de la respuesta.If successful, this method returns a 200 OK response code and a list of chatMessages in the response body.

EjemploExample

SolicitudRequest

GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/chats/getAllMessages

RespuestaResponse

Nota: el objeto de respuesta que se muestra aquí podría acortarse para facilitar la legibilidad.Note: The response object shown here might be shortened for readability.

HTTP/1.1 200 OK 
Content-type: application/json 
Content-length: 347 

{
   "@odata.context":"https://graph.microsoft.com/beta/$metadata#Collection(chatMessage)",
   "@odata.count":10,
   "@odata.nextLink":"https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/chats/getAllMessages?$skip=10",
   "value":[
      {
         "@odata.type":"#microsoft.graph.chatMessage",
         "id":"1600457965467",
         "replyToId":null,
         "etag":"1600457965467",
         "messageType":"message",
         "createdDateTime":"2020-09-18T19:39:25.467Z",
         "lastModifiedDateTime":"2020-09-18T19:39:25.467Z",
         "lastEditedDateTime":null,
         "deletedDateTime":null,
         "subject":null,
         "summary":null,
         "chatId":"19:0de69e5e-2da8-4cf2-821f-5e6585b2c65b_5c64e248-3269-4268-a36e-0f80314e9c39@unq.gbl.spaces",
         "importance":"normal",
         "locale":"en-us",
         "webUrl":null,
         "channelIdentity":null,
         "policyViolation":null,
         "from":{
            "application":null,
            "device":null,
            "conversation":null,
            "user":{
               "id":"0de69e5e-2da8-4cf2-821f-5e6585b2c65b",
               "displayName":"Richard Wilson",
               "userIdentityType":"aadUser"
            }
         },
         "body":{
            "contentType":"html",
            "content":"<div>\n<blockquote itemscope=\"\" itemtype=\"http://schema.skype.com/Reply\" itemid=\"1600457867820\">\n<strong itemprop=\"mri\" itemid=\"8:orgid:0de69e5e-2da8-4cf2-821f-5e6585b2c65b\">Richard Wilson</strong><span itemprop=\"time\" itemid=\"1600457867820\"></span>\n<p itemprop=\"preview\">1237</p>\n</blockquote>\n<p>this is a reply</p>\n</div>"
         },
         "attachments":[
            
         ],
         "mentions":[
            
         ],
         "reactions":[
            
         ]
      }
   ]
}