La API de Gmail usa recursos de Thread
para agrupar las respuestas de correo electrónico con su mensaje original en una sola conversación o conversación. Esto te permite recuperar todos los mensajes de una conversación en orden, lo que facilita tener contexto para un mensaje o definir mejor los resultados de la búsqueda.
Al igual que los mensajes, es posible que los subprocesos también tengan etiquetas aplicadas. Sin embargo, a diferencia de los mensajes, las conversaciones no se pueden crear, solo se pueden borrar. Sin embargo, los mensajes se pueden insertar en una conversación.
Contenido
Cómo recuperar subprocesos
Las conversaciones proporcionan una forma sencilla de recuperar los mensajes de una conversación en orden.
Si enumeras un conjunto de conversaciones, puedes agrupar los mensajes por conversación y proporcionar contexto adicional. Puedes obtener una lista de subprocesos con el método threads.list
o un subproceso específico con threads.get
. También puedes filtrar subprocesos con los mismos parámetros de consulta que para el recurso Message
. Si algún mensaje de un subproceso coincide con la consulta, ese subproceso se muestra en el resultado.
En la muestra de código que aparece a continuación, se explica cómo usar ambos métodos en una muestra que muestra las conversaciones con más tráfico en tu bandeja de entrada. El método threads.list
recupera todos los IDs de subproceso y, luego, threads.get
captura todos los mensajes de cada subproceso.
Para aquellos con 3 o más respuestas, extraemos la línea Subject
y mostramos las que no están vacías más la cantidad de mensajes en el subproceso. También encontrarás esta muestra de código en el video de DevByte correspondiente.
Python
Agregar borradores y mensajes a las conversaciones
Si envías o migras mensajes que son una respuesta a otro correo electrónico o parte de una conversación, tu aplicación debe agregar ese mensaje a la conversación relacionada. Esto permite que los usuarios de Gmail que participan en la conversación mantengan el mensaje en contexto con mayor facilidad.
Se puede agregar un borrador a un subproceso como parte de la creación, la actualización o el envío de un mensaje de borrador. También puedes agregar un mensaje a una conversación como parte de la inserción o el envío de un mensaje.
Para formar parte de una conversación, un mensaje o borrador debe cumplir con los siguientes criterios:
- El
threadId
solicitado se debe especificar en elMessage
o elDraft.Message
que proporciones en la solicitud. - Los encabezados
References
yIn-Reply-To
deben configurarse de acuerdo con el estándar RFC 2822. - Los encabezados
Subject
deben coincidir.
Consulta los ejemplos de cómo crear un borrador o enviar un mensaje. En ambos casos, simplemente agregarías una clave threadId
vinculada con un ID de subproceso a los metadatos de un mensaje, el objeto message
.