- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Wypróbuj
Wyświetla listę wątków w skrzynce pocztowej użytkownika.
Żądanie HTTP
GET https://gmail.googleapis.com/gmail/v1/users/{userId}/threads
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 wątków 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 wątki pasujące do określonego zapytania. Obsługuje ten sam format zapytań co pole wyszukiwania Gmaila. Na przykład: |
labelIds[] |
Zwracaj tylko wątki z etykietami, które pasują do wszystkich określonych identyfikatorów etykiet. |
includeSpamTrash |
Uwzględnij w wynikach wątki z domeny |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"threads": [
{
object ( |
Pola | |
---|---|
threads[] |
Lista wątków. Pamiętaj, że każdy zasób wątku nie zawiera listy |
nextPageToken |
Token strony, aby pobrać następną stronę 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.