Reading

List email threads with optional filters, one page at a time. When more follow, the last line gives a pageToken: call again with the same filters and that pageToken for the next page, until none is given. sort is newest (the default), oldest, sender or subject, the same four orders the thread list offers. dateFrom and dateTo are ISO 8601 instants, both included, read against the newest message on each thread. fromContacts keeps only threads whose newest message came from a saved contact. A thread whose newest message arrived encrypted is marked as such on its own line: its subject, sender and date are listed exactly as any other thread’s, but getThread will not return a body for it. Read the marker before planning a call that needs the text. Set semantic to true when the person describes mail rather than naming its words: query then matches by meaning and the closest threads come first. address keeps only the threads delivered to that one address, as the address filter of the app does. category keeps one inbox tab: primary, promotions, updates, social or forums.

Get detailed information about a specific email thread. A message that arrived encrypted (PGP or S/MIME) returns a marker in place of its body rather than any text: this server holds no key and cannot open it, and no retry will change that. Sender, subject, date and labels are not hidden by encryption and come back in full. Relay such a message as encrypted. Never report it as empty. When the latest message is a sign-in or verification code email from an authenticated sender and holds exactly one code, that code comes back on its own line.

Get the summary of a specific email thread. A thread holding a message that arrived encrypted (PGP or S/MIME) is never summarised (its body was never read), and this says so rather than reporting that no summary exists. A thread that was summarised before an encrypted message arrived in it returns that older summary, labelled as not covering the encrypted one.

Get the current date and time

How many conversations each folder holds and how many of them are unread, as the sidebar shows them, how many drafts are waiting, how many conversations each label has in each folder, and how many inbox conversations arrived at each address. The unread row counts the unread conversations in the inbox, and the draft row counts drafts. The tab rows count the inbox conversations in each inbox tab (primary, promotions, updates, social, forums) and how many of them are unread. The unlabelled rows count the inbox conversations that carry none of the labels, in total and by tab, which is what the inbox of the app lists unless Labelled mail is ticked in its Filters menu. The team rows count the open conversations assigned to you, the open conversations nobody has, and the conversations that mention you, with how many of those mentions you have not opened yet. address narrows every count to mail delivered to that one address.

What is known about the organisation behind a sender: the line the reading pane shows under an unfamiliar sender, kept per domain and shared by every address under it, subdomains included, and looked up again after 30 days. Give any address of the sender; only its domain is read. Personal mailbox providers such as Gmail and the domains of this workspace are never looked up. research true looks a domain nobody has looked up yet up on the web and keeps the answer, which only the workspace owner may do, with a connection that reaches every address.