En este documento, se describen las extensiones de IMAP proporcionadas por Gmail y cómo pueden usarlas los desarrolladores. En este documento, se asume que conoces el protocolo IMAP.
Descripción general
Gmail proporciona un conjunto de extensiones de IMAP para permitir que los autores de los clientes IMAP proporcionen una experiencia más similar a la de Gmail a través de IMAP. Es posible que los desarrolladores que integran las funciones de Gmail en sus apps web o para dispositivos móviles usen la API de Gmail RESTful.
Las extensiones se pueden utilizar cuando se accede a Gmail por medio del protocolo IMAP estándar o cuando se conecta a través de OAuth.
Verifica la presencia de extensiones
Gmail anuncia la compatibilidad con extensiones en su respuesta al comando CAPABILITY
. La compatibilidad de las extensiones en este documento se indica por la presencia de X-GM-EXT-1
en la lista de capacidades compatibles.
Se recomienda a los clientes que se presenten con el comando IMAP ID (RFC 2971) y que incluyan una dirección de contacto como resguardo en caso de que se requieran cambios en estas extensiones.
El siguiente es un ejemplo de protocolo de enlace y el uso del comando CAPABILITY
en el extremo IMAP de Gmail:
* OK Gimap ready for requests from 127.0.0.1 k2if6111336rvb.0
a001 LOGIN username@gmail.com password
a001 OK username@gmail.com authenticated (Success)
a001 OK Login successful
a002 CAPABILITY
* CAPABILITY IMAP4rev1 UNSELECT LITERAL+ IDLE NAMESPACE QUOTA ID XLIST CHILDREN X-GM-EXT-1
a002 OK Success
a003 ID ("name" "clientname" "version" "1.2.3" "vendor" "companyname" "contact" "foo@example.com")
* ID ("name" "GImap" "vendor" "Google, Inc." "support-url" "http://mail.google.com/support" "remote-host" "127.0.0.1")
a003 OK Success
Extensión de uso especial del comando LIST
Gmail admite la extensión IMAP LIST para buzones de correo de uso especial, que proporciona nuevos atributos para las carpetas especiales. Estos atributos permiten que el cliente sepa qué carpetas son especiales (p. ej., \All
). La lista actual de carpetas especiales consta de las siguientes opciones: Destacados, Importantes, Elementos enviados, Borradores, Spam, Todos y Papelera. Todas las respuestas LIST
contienen estos atributos de uso especial; este no es un CAPABILITY
nuevo ni algo que los clientes deban ser ENABLEd
.
El siguiente es un ejemplo de transcripción de una llamada a LIST
:
a004 LIST "" "*"
* LIST (\HasNoChildren) "/" "INBOX"
* LIST (\Noselect \HasChildren) "/" "[Gmail]"
* LIST (\HasNoChildren \All) "/" "[Gmail]/All Mail"
* LIST (\HasNoChildren \Drafts) "/" "[Gmail]/Drafts"
* LIST (\HasNoChildren \Important) "/" "[Gmail]/Important"
* LIST (\HasNoChildren \Sent) "/" "[Gmail]/Sent Mail"
* LIST (\HasNoChildren \Junk) "/" "[Gmail]/Spam"
* LIST (\HasNoChildren \Flagged) "/" "[Gmail]/Starred"
* LIST (\HasNoChildren \Trash) "/" "[Gmail]/Trash"
a004 OK Success
La respuesta sigue el estándar de uso especial con un atributo \Important
adicional agregado para Prioritarios de Gmail (es decir, "[Gmail]/Important"
).
XLIST dejó de estar disponible
El comando XLIST
específico de Gmail dejó de estar disponible en 2013 y se reemplazó por el Estándar de listas de uso especial de IMAP. Se recomienda a los clientes migrar de XLIST
al estándar de la industria de uso especial lo antes posible. Ten en cuenta que los nombres de los atributos estándar de uso especial son similares, pero no idénticos, a los nombres de los atributos XLIST
heredados.
Extensión del comando SEARCH: X-GM-RAW
Para proporcionar acceso a la sintaxis de búsqueda completa de Gmail, Gmail proporciona el atributo de búsqueda X-GM-RAW
. Los argumentos que se pasan con el atributo X-GM-RAW
cuando se ejecutan los comandos SEARCH
o UID SEARCH
se interpretarán de la misma manera que en la interfaz web de Gmail.
El siguiente es un ejemplo de transcripción de una llamada a SEARCH
con el atributo X-GM-RAW
:
a005 SEARCH X-GM-RAW "has:attachment in:unread"
* SEARCH 123 12344 5992
a005 OK SEARCH (Success)
Acceso al ID de mensaje único de Gmail: X-GM-MSGID
Gmail proporciona un único ID de mensaje para cada correo electrónico, de modo que un único mensaje se pueda identificar en varias carpetas. La recuperación de este ID de mensaje es compatible con el atributo X-GM-MSGID
en el comando FETCH
. El ID del mensaje es un número entero sin firma de 64 bits y es el equivalente decimal de la cadena hexadecimal del ID que se usa en la interfaz web y la API de Gmail.
El siguiente es un ejemplo de transcripción de una llamada para recuperar el X-GM-MSGID
de un mensaje con el comando FETCH
:
a006 FETCH 1 (X-GM-MSGID)
* 1 FETCH (X-GM-MSGID 1278455344230334865)
a006 OK FETCH (Success)
El atributo X-GM-MSGID
también se puede usar en los comandos SEARCH
o UID SEARCH
para encontrar los números de secuencia o el UID
de un mensaje en función del ID del mensaje de Gmail. El siguiente es un ejemplo de transcripción de una llamada para recuperar el UID
de un mensaje con el comando UID SEARCH
:
a007 UID SEARCH X-GM-MSGID 1278455344230334865
* SEARCH 1
a007 OK SEARCH (Success)
Acceso a la ID de conversación de Gmail: X-GM-THRID
Gmail proporciona un ID de conversación para asociar grupos de mensajes de la misma manera que en la interfaz web de Gmail. Se admite la recuperación de este ID de subproceso a través del atributo X-GM-THRID
en el comando FETCH
. El ID del subproceso es un número entero sin firma de 64 bits y es el equivalente decimal de la cadena hexadecimal del ID que se usa en la interfaz web y la API de Gmail.
El siguiente es un ejemplo de transcripción de una llamada para recuperar el X-GM-THRID
de varios mensajes (en dos subprocesos) con el comando FETCH
:
a008 FETCH 1:4 (X-GM-THRID)
* 1 FETCH (X-GM-THRID 1278455344230334865)
* 2 FETCH (X-GM-THRID 1266894439832287888)
* 3 FETCH (X-GM-THRID 1266894439832287888)
* 4 FETCH (X-GM-THRID 1266894439832287888)
a008 OK FETCH (Success)
También se puede usar el atributo X-GM-THRID
en los comandos SEARCH
o UID SEARCH
para encontrar los números de secuencia o los elementos UID
de los mensajes en un subproceso determinado. El siguiente es un ejemplo de transcripción de una llamada para recuperar los UID
de varios mensajes con el comando UID SEARCH
:
a009 UID SEARCH X-GM-THRID 1266894439832287888
* SEARCH 2 3 4
a009 OK Search (Success)
Acceso a las etiquetas de Gmail: X-GM-LABELS
Gmail trata las etiquetas como carpetas para los fines del acceso IMAP. Por lo tanto, las etiquetas se pueden modificar con los comandos estándar de IMAP, CREATE
, RENAME
y DELETE
, que actúan sobre las carpetas. Las etiquetas del sistema, que son las que crea Gmail, están reservadas y tienen el prefijo "[Gmail]" o "[GoogleMail]" en la lista de etiquetas. Usa el comando XLIST
para obtener la lista completa de etiquetas de un buzón.
Las etiquetas de un mensaje determinado se pueden recuperar mediante el atributo X-GM-LABELS
con el comando FETCH
. El atributo se muestra como una lista de ASTRING
, codificados en UTF-7, según corresponda. Un ASTRING
es un atom o una string, según se define en el RFC.
El siguiente es un ejemplo de transcripción de una llamada para recuperar el X-GM-LABELS
de varios mensajes con el comando FETCH
:
a010 FETCH 1:4 (X-GM-LABELS)
* 1 FETCH (X-GM-LABELS (\Inbox \Sent Important "Muy Importante"))
* 2 FETCH (X-GM-LABELS (foo))
* 3 FETCH (X-GM-LABELS ())
* 4 FETCH (X-GM-LABELS (\Drafts))
a010 OK FETCH (Success)
Se pueden agregar etiquetas a un mensaje mediante el comando STORE
junto con el atributo X-GM-LABELS
. La siguiente es una transcripción de ejemplo que demuestra la adición de una etiqueta a un mensaje:
a011 STORE 1 +X-GM-LABELS (foo)
* 1 FETCH (X-GM-LABELS (\Inbox \Sent Important "Muy Importante" foo))
a011 OK STORE (Success)
El atributo X-GM-LABELS
también se puede usar en los comandos SEARCH
o UID SEARCH
para encontrar los números de secuencia o los UID
de todos los mensajes de la carpeta con una etiqueta determinada. El siguiente es un ejemplo de transcripción de una llamada para recuperar los números de secuencia de varios mensajes con el comando SEARCH
:
a012 SEARCH X-GM-LABELS foo
* SEARCH 1 2
a012 OK SEARCH (Success)
Referencias
- IMAP: RFC 3501: PROTOCOLO DE ACCESO A MENSAJES DE INTERNET - VERSIÓN 4rev1
- ID de IMAP: RFC 2971: EXTENSIÓN DE ID DE IMAP4
- Uso especial de IMAP: RFC 6154: Extensión IMAP LIST para buzones de correo de uso especial