- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Wypróbuj
Wyświetla listę wiadomości w skrzynce pocztowej użytkownika.
Żą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 |
Adres e-mail użytkownika. Specjalna wartość |
Parametry zapytania
Parametry | |
---|---|
maxResults |
Maksymalna liczba wiadomości do zwrócenia. Domyślna wartość w tym polu to 100. Maksymalna dozwolona wartość w tym polu to 500. |
pageToken |
Token strony do pobrania określonej strony z wynikami na liście. |
q |
Zwracaj tylko wiadomości pasujące do podanego zapytania. Obsługuje ten sam format zapytań co pole wyszukiwania Gmaila. Na przykład: |
labelIds[] |
Zwracaj tylko wiadomości z etykietami, które pasują do 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 |
Uwzględnij w wynikach wiadomości od: |
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 ( |
Pola | |
---|---|
messages[] |
Lista wiadomości. Pamiętaj, że każdy zasób wiadomości zawiera tylko |
nextPageToken |
Token do pobierania następnej strony wyników na liście. |
resultSizeEstimate |
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.