![]() ![]() Arguments passed along with the X-GM-RAW attribute when executing the SEARCH or UID SEARCH commands will be interpreted in the same manner as in the Gmail web interface. To provide access to the full Gmail search syntax, Gmail provides the X-GM-RAW search attribute. Extension of the SEARCH command: X-GM-RAW Note that the Special-Use standard attribute names are similar but not identical to the legacy XLIST attribute names. Clients are strongly encouraged to migrate from XLIST to the Special-Use industry standard as soon as possible. The Gmail-specific XLIST command was deprecated in 2013 in favor of the IMAP Special-Use List Standard. The response follows the Special-Use standard with an additional \Important attribute added for Gmail's Priority Inbox (i.e. * LIST (\HasNoChildren \Trash) "/" "/Trash" * LIST (\HasNoChildren \Flagged) "/" "/Starred" * LIST (\HasNoChildren \Junk) "/" "/Spam" * LIST (\HasNoChildren \Sent) "/" "/Sent Mail" * LIST (\HasNoChildren \Important) "/" "/Important" * LIST (\HasNoChildren \Drafts) "/" "/Drafts" * LIST (\HasNoChildren \All) "/" "/All Mail" The following is an example transcript of a call to LIST: a004 LIST "" "*" All LIST responses contain these Special-Use attributes this is not a new CAPABILITY or something that needs to be ENABLEd by clients. The current list of special folders consists of: Starred, Important, Sent Items, Drafts, Spam, All Mail, and Trash. These attributes let the client know which folders are special (eg. Gmail supports the IMAP LIST Extension for Special-Use Mailboxes, which provides new attributes for special folders. Special-Use Extension of the LIST command ![]() * CAPABILITY IMAP4rev1 UNSELECT LITERAL IDLE NAMESPACE QUOTA ID XLIST CHILDREN X-GM-EXT-1Ī003 ID ("name" "clientname" "version" "1.2.3" "vendor" "companyname" "contact" ID ("name" "GImap" "vendor" "Google, Inc." "support-url" "" "remote-host" "127.0.0.1") The following is an example handshake and use of the CAPABILITY command on the Gmail IMAP endpoint: * OK Gimap ready for requests from 127.0.0.1 k2if6111336rvb.0 The support of extensions in this document are indicated by the presence of X-GM-EXT-1 in the list of supported capabilities.Ĭlients are strongly recommended to announce themselves with the IMAP ID command ( RFC 2971), and include a contact address as a fallback in case changes to these extensions are required. Gmail advertises its extension support in its response to the CAPABILITY command. The extensions may be used when accessing Gmail through the standard IMAP protocol or when connecting via OAuth. Developers integrating Gmail features into their web or mobile apps may instead want to use the RESTful Gmail API. Gmail provides a set of IMAP extensions to allow authors of IMAP clients provide a more Gmail-like experience through IMAP. This document assumes familiarity with the IMAP protocol. Tip: Usually, you’ll need to enter an app password once per app or device.This document describes the IMAP extensions provided by Gmail and how they may be used by developers.
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |