Method: users.threads.list

Отображает список веток обсуждений в почтовом ящике пользователя.

HTTP-запрос

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/threads

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
userId

string

Адрес электронной почты пользователя. Специальное значение me может использоваться для обозначения авторизованного пользователя.

Параметры запроса

Параметры
maxResults

integer ( uint32 format)

Максимальное количество потоков для возврата. Значение по умолчанию для этого поля — 100. Максимально допустимое значение для этого поля — 500.

pageToken

string

Токен страницы для получения конкретной страницы результатов в списке.

q

string

Возвращает только те ветки обсуждения, которые соответствуют указанному запросу. Поддерживает тот же формат запроса, что и поле поиска Gmail. Например, "from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread" . Этот параметр нельзя использовать при доступе к API с использованием области видимости gmail.metadata.

labelIds[]

string

Возвращать только те потоки, метки которых соответствуют всем указанным идентификаторам меток.

includeSpamTrash

boolean

Включите в результаты сообщения из разделов SPAM и TRASH .

Текст запроса

Тело запроса должно быть пустым.

Ответный текст

В случае успеха тело ответа будет содержать данные следующей структуры:

JSON-представление 
{
  "threads": [
    {
      object (Thread)
    }
  ],
  "nextPageToken": string,
  "resultSizeEstimate": integer
}
Поля
threads[]

object ( Thread )

Список потоков. Обратите внимание, что каждый ресурс потока не содержит списка messages . Список messages для данного потока можно получить с помощью метода threads.get .

nextPageToken

string

Токен страницы для получения следующей страницы результатов в списке.

resultSizeEstimate

integer ( uint32 format)

Примерное общее количество результатов.

Области полномочий

Требуется один из следующих диапазонов аутентификации OAuth:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/gmail.metadata

Для получения более подробной информации см.OAuth 2.0 Overview .