Method: spaces.messages.list

• Solicitud HTTP
• Parámetros de ruta de acceso
• Parámetros de consulta
• Cuerpo de la solicitud
• Cuerpo de la respuesta
  • Representación JSON
• Alcances de la autorización

Vista previa para desarrolladores: Está disponible como parte del Programa de Versión preliminar para desarrolladores de Google Workspace, que otorga acceso anticipado a ciertas funciones.

Enumera los mensajes de un espacio del que es miembro el emisor, incluidos los mensajes de los miembros y espacios bloqueados. Requiere autenticación de usuario y el permiso de autorización chat.messages o chat.messages.readonly.

Solicitud HTTP

GET https://chat.googleapis.com/v1/{parent=spaces/*}/messages

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent	string Obligatorio. El nombre del recurso del espacio desde el que se enumeran los mensajes. Formato: espacios/{space}

Parámetros de consulta

Parámetros
pageSize	integer La cantidad máxima de mensajes mostrados. Es posible que el servicio muestre menos mensajes que este valor. Si no se especifica, se muestran 25 como máximo. El valor máximo es 1,000; los valores superiores a 1,000 se convierten en 1,000. Los valores negativos muestran un error INVALID_ARGUMENT.
pageToken	string Opcional, si se reanuda desde una consulta anterior. Un token de página recibido de una llamada de lista de mensajes anterior. Proporciona esto para recuperar la página siguiente. Cuando realices la paginación, todos los demás parámetros proporcionados deben coincidir con la llamada que proporcionó el token de la página. Pasar diferentes valores a los otros parámetros puede generar resultados inesperados.
filter	string Un filtro de consulta. La API admite el filtrado por create_time y thread.name. Por ejemplo, las siguientes consultas son válidas: create_time > "2012-04-21T11:30:00-04:00" create_time > "2012-04-21T11:30:00-04:00" AND thread.name = spaces/AAAAAAAAAAA/threads/123 create_time > "2012-04-21T11:30:00+00:00" AND create_time < "2013-01-01T00:00:00+00:00" AND thread.name = spaces/AAAAAAAAAAA/threads/123 Ten en cuenta que la marca de tiempo create_time debe estar entre comillas dobles. La consulta admite como máximo 1 subproceso. El servidor rechaza las consultas no válidas con un error INVALID_ARGUMENT.
orderBy	string Opcional, si se reanuda desde una consulta anterior. Cómo se ordena la lista de mensajes. Especifica un valor y una operación de ordenamiento. Los valores válidos de operación de ordenamiento son los siguientes: ASC para el orden ascendente DESC para descendente El orden predeterminado es create_time ASC. La sintaxis admitida es la siguiente: create_time ASC
showDeleted	boolean Indica si se deben incluir los mensajes eliminados. Los mensajes eliminados incluyen el tiempo y los metadatos eliminados, pero el contenido del mensaje no está disponible.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si el proceso es satisfactorio, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON
{ "messages": [ { object (Message) } ], "nextPageToken": string }

Campos
messages[]	object (Message) Lista de mensajes.
nextPageToken	string Un token que se puede enviar como pageToken para recuperar la siguiente página de resultados. Si está vacía, no hay páginas posteriores.

Alcances de la autorización

Se necesita uno de los siguientes alcances de OAuth:

• https://www.googleapis.com/auth/chat.messages
• https://www.googleapis.com/auth/chat.messages.readonly

Para obtener más información, consulta la guía de autorización.