Method: users.threads.get

Получает указанный поток.

HTTP-запрос

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

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

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

Параметры
userId

string

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

id

string

Идентификатор потока, который необходимо получить.

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

Параметры
format

enum ( Format )

Формат, в котором будут возвращаться сообщения.

metadataHeaders[]

string

Если указан формат METADATA, следует включать только указанные заголовки.

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

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

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

В случае успеха тело ответа содержит экземпляр класса Thread .

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

Требуется один из следующих диапазонов аутентификации 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
  • https://www.googleapis.com/auth/gmail.addons.current.message.metadata
  • https://www.googleapis.com/auth/gmail.addons.current.message.readonly
  • https://www.googleapis.com/auth/gmail.addons.current.message.action

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

Формат

Перечисления
full Возвращает полные данные электронного письма, включая содержимое тела, проанализированное в поле payload ; поле raw не используется. Формат нельзя использовать при доступе к API через область видимости gmail.metadata.
metadata Возвращает только идентификаторы электронных писем, метки и заголовки писем.
minimal Возвращает только идентификаторы и метки электронных писем; не возвращает заголовки, текст письма или полезную нагрузку.