Method: users.messages.list

Wyświetla listę wiadomości w skrzynce pocztowej użytkownika. Przykłady użycia znajdziesz w artykule Wyświetlanie listy wiadomości w Gmailu.

Żądanie HTTP

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

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 wiadomości do zwrócenia. Domyślna wartość tego pola to 100. Maksymalna dozwolona wartość tego pola to 500.
pageToken

string

Token strony umożliwiający pobranie konkretnej strony wyników na liście.
q

string

Zwracaj tylko 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". Nie można użyć parametru podczas uzyskiwania dostępu do interfejsu API za pomocą zakresu gmail.metadata.
labelIds[]

string

Zwraca tylko wiadomości z etykietami, które pasują do wszystkich podanych identyfikatorów etykiet. Wiadomości w wątku mogą mieć etykiety, których nie mają inne wiadomości w tym samym wątku. Więcej informacji znajdziesz w artykule Zarządzanie etykietami wiadomości i wątków.
includeSpamTrash

boolean

Uwzględniaj w wynikach wiadomości 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 
{
  "messages": [
    {
      object (Message)
    }
  ],
  "nextPageToken": string,
  "resultSizeEstimate": integer
}
Pola
messages[]

object (Message)

Lista wiadomości. Pamiętaj, że każdy zasób wiadomości zawiera tylko elementy id i threadId. Dodatkowe szczegóły wiadomości można pobrać za pomocą metody messages.get.
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.readonly
  • https://www.googleapis.com/auth/gmail.metadata

Więcej informacji znajdziesz w przewodniku po autoryzacji.