Method: users.drafts.list

Wyświetla listę wersji roboczych w skrzynce pocztowej użytkownika.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
userId

string

Adres e-mail użytkownika. Specjalna wartość me może służyć do wskazania uwierzytelnionego użytkownika.

Parametry zapytania

Parametry
maxResults

integer (uint32 format)

Maksymalna liczba wersji roboczych do zwrócenia. Domyślna wartość w tym polu to 100. Maksymalna dozwolona wartość w tym polu to 500.
pageToken

string

Token strony do pobrania określonej strony z wynikami na liście.
q

string

Zwracaj tylko wersje robocze wiadomości pasujących do podanego zapytania. Obsługuje ten sam format zapytań co pole wyszukiwania Gmaila. Na przykład: "from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread".
includeSpamTrash

boolean

Uwzględnij w wynikach wersje robocze z SPAM i TRASH.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "drafts": [
    {
      object (Draft)
    }
  ],
  "nextPageToken": string,
  "resultSizeEstimate": integer
}
Pola
drafts[]

object (Draft)

Lista wersji roboczych. Pamiętaj, że właściwość Message w każdym zasobie Draft zawiera tylko właściwości id i threadId. Metoda messages.get może pobierać dodatkowe szczegóły wiadomości.
nextPageToken

string

Token do pobierania następnej strony wyników na liście.
resultSizeEstimate

integer (uint32 format)

Szacunkowa łączna liczba wyników.

Zakresy autoryzacji

Wymaga jednego z tych zakresów 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

Więcej informacji znajdziesz w przewodniku po autoryzacji.