users
Lists the threads in the user's mailbox. For more information, see Manage threads.
get/gmail/v1/users/{userId}/threads
Path parameters
userIdstring required
The user's email address. The special value me can be used to indicate the authenticated user.
Query parameters
includeSpamTrashboolean
Include threads from SPAM and TRASH in the results.
labelIdsstring[]
Only return threads with labels that match all of the specified label IDs.
maxResultsinteger
Maximum number of threads to return. This field defaults to 100. The maximum allowed value for this field is 500.
pageTokenstring
Page token to retrieve a specific page of results in the list.
qstring
Only return threads matching the specified query. Supports the same query format as the Gmail search box. For example, "from:someuser@example.com rfc822msgid: is:unread". Parameter cannot be used when accessing the api using the gmail.metadata scope.
Response
Successful response