searchEmails
Search Emails
Search the user's Gmail messages with Gmail query syntax ('from:user@example.com', 'is:unread', 'subject:meeting', 'in:sent').
Arguments
accountIdstringoptionalConnected account this acts on: an accountId or email from listMailAccounts. Omit for the primary account. Pass the SAME account you found the message / draft / label in: a Gmail id is per-account, so aiming a non-primary id at the…maxResultsnumberoptionalMaximum number of resultsquerystringrequiredGmail search query
Returns
The registry does not declare a return shape.
Declared limits
maxResults: minimum 1maxResults: maximum 50
Ask for it
The Cloud routes these requests to this verb.
- find emails from X
- search my inbox for Y
- any unread mail
Pair it with
The verbs that finish the job.