Method: users.drafts.list

Zawiera 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. Do wskazywania uwierzytelnionego użytkownika można użyć wartości specjalnej me.

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, który pozwala pobrać konkretną stronę wyników na liście.
q

string

Zwraca tylko wersje robocze wiadomości pasujące do określonego zapytania. Obsługuje ten sam format zapytania co pole wyszukiwania w Gmailu. Na przykład: "from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread".
includeSpamTrash

boolean

W wynikach uwzględnij wersje robocze od 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 atrybuty id i threadId. Metoda messages.get może pobrać dodatkowe szczegóły wiadomości.
nextPageToken

string

Token do pobrania 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 protokołu 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 na temat autoryzacji.