Method: users.drafts.list

Wyświetla szkice 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. Wartość specjalna me może służyć do wskazywania uwierzytelnionego użytkownika.

Parametry zapytania

Parametry
maxResults

integer (uint32 format)

Maksymalna liczba wersji roboczych do zwrócenia. Domyślna wartość tego pola to 100. Maksymalna dozwolona wartość tego pola to 500.
pageToken

string

token strony, aby pobrać określoną stronę wyników na liście;
q

string

Zwracaj tylko wersje robocze wiadomości pasujące do określonego zapytania. Obsługuje ten sam format zapytań co pole wyszukiwania w Gmailu. 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żdej usłudze Draft zawiera tylko atrybuty id i threadId. Metoda messages.get może pobierać dodatkowe informacje o wiadomości.
nextPageToken

string

Token do pobierania kolejnej 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 dotyczącym autoryzacji.