Method: users.drafts.list

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

HTTP-запрос

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

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" .

includeSpamTrash

boolean

Включайте в результаты черновики из SPAM и TRASH .

Тело запроса

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

Тело ответа

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

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

object ( Draft )

Список черновиков. Обратите внимание, что свойство Message в каждом ресурсе Draft содержит только id и threadId . Метод messages.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.compose
  • https://www.googleapis.com/auth/gmail.readonly

Дополнительную информацию см. в руководстве по авторизации .