Cómo buscar mensajes

Puedes buscar o filtrar archivos con los métodos messages.list y threads.list. Estos métodos aceptan el parámetro q, que admite la mayoría de la misma sintaxis de búsqueda avanzada que la interfaz web de Gmail. Para obtener una lista de las diferencias entre la búsqueda y los filtros de la IU de Gmail y la API de Gmail, consulta Diferencias entre los filtros de búsqueda: IU de Gmail y API de Gmail.

Esta sintaxis avanzada te permite usar búsquedas para filtrar mensajes por propiedades como el remitente, la fecha o la etiqueta, por mencionar algunas posibilidades. Por ejemplo, la siguiente consulta recupera todos los mensajes que envió el usuario en enero de 2014:

GET https://www.googleapis.com/gmail/v1/users/me/messages?q=in:sent after:2014/01/01 before:2014/02/01

Advertencia: Todas las fechas que se usan en la búsqueda se interpretan como la medianoche de esa fecha en la zona horaria PST. Para especificar fechas precisas para otras zonas horarias, pasa el valor en segundos:

?q=in:sent after:1388552400 before:1391230800

Además de las búsquedas, también puedes filtrar mensajes y subprocesos por etiqueta con el parámetro labelIds. Esto te permite buscar mensajes y conversaciones con las etiquetas de sistema o de usuario especificadas. Para obtener más información, consulta la referencia del método messages.list o threads.list.

Diferencias entre la búsqueda y el filtrado: IU de Gmail en comparación con la API de Gmail

• La IU de Gmail realiza una expansión de alias que le permite inferir un alias de cuenta a partir de una cuenta de Google Workspace. Por ejemplo, supongamos que tienes una cuenta de [e-mail] y tu administrador configura un alias para esa cuenta de [e-mail]. Si [e-mail] envía un correo electrónico, pero buscas "from: [e-mail])", el correo electrónico que envió [e-mail] aparece como resultado de la búsqueda en la IU de Gmail, pero no en la respuesta de la API.

• La IU de Gmail permite a los usuarios realizar búsquedas en todo el subproceso, pero la API no.