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 parte de la misma sintaxis de búsqueda avanzada que la interfaz web de Gmail. Para obtener una lista de las diferencias de búsqueda y filtrado entre 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 parafiltrar mensajes por propiedades, como el remitente, la fecha o la etiqueta, entre otras 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 del Pacífico. 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 conversaciones por etiqueta con el parámetro labelIds. Esto te permite buscar mensajes y conversaciones con las etiquetas del sistema o del 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 de la IU de Gmail y la API de Gmail

• La IU de Gmail realiza la expansión de alias, lo que le permite inferir un alias de cuenta 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] aparecerá 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 toda la conversación, pero la API no.