Listet die Threads im Postfach des Nutzers auf.
HTTP-Anfrage
GET https://gmail.googleapis.com/gmail/v1/users/{userId}/threads
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
userId |
Die E-Mail-Adresse des Nutzers. Mit dem speziellen Wert |
Abfrageparameter
Parameter | |
---|---|
maxResults |
Maximale Anzahl der zurückzugebenden Threads. Der Standardwert in diesem Feld ist 100. Der maximal zulässige Wert für dieses Feld beträgt 500. |
pageToken |
Seitentoken zum Abrufen einer bestimmten Seite mit Ergebnissen in der Liste. |
q |
Es werden nur Threads zurückgegeben, die der angegebenen Abfrage entsprechen. Unterstützt dasselbe Abfrageformat wie das Gmail-Suchfeld Beispiel: |
labelIds[] |
Nur Threads mit Labels zurückgeben, die mit allen angegebenen Label-IDs übereinstimmen. |
includeSpamTrash |
Threads aus |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:
JSON-Darstellung |
---|
{
"threads": [
{
object ( |
Felder | |
---|---|
threads[] |
Liste der Threads. Beachten Sie, dass jede Thread-Ressource keine Liste von |
nextPageToken |
Seitentoken zum Abrufen der nächsten Seite mit Ergebnissen in der Liste. |
resultSizeEstimate |
Geschätzte Gesamtzahl der Ergebnisse |
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
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
Weitere Informationen finden Sie in der Übersicht zu OAuth 2.0.