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 casi la misma sintaxis de búsqueda avanzada que la interfaz web de Gmail. Para obtener una lista de las diferencias de búsqueda y filtro entre la IU de Gmail y la API de Gmail, consulta Diferencias entre la IU de Gmail y la API de Gmail.

Esta sintaxis avanzada te permite usar búsquedas para filtrar mensajes por propiedades, como el remitente, la fecha o la etiqueta, y nombrar 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 usadas en la búsqueda se interpretan como medianoche en esa fecha en la zona horaria PST. Si quieres 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 subprocesos con las etiquetas de usuario o del sistema especificadas aplicadas. Para obtener más información, consulta la referencia del método messages.list o threads.list.

Diferencias en la búsqueda y los filtros: IU de Gmail en comparación con la API de Gmail

• La IU de Gmail realiza la expansión de alias, lo que le permite inferir un alias de una cuenta de Google Workspace. Por ejemplo, supongamos que tienes una cuenta de [e-mail] y el administrador establece un alias de [e-mail] para esa cuenta. Si [e-mail] envía un correo electrónico, pero buscas "from: [e-mail])", el correo electrónico enviado por [e-mail] aparecerá como un 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 lo hace.