Method: users.settings.filters.list

Listet die Nachrichtenfilter eines Gmail-Nutzers auf.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
userId

string

E-Mail-Adresse des Nutzers. Mit dem speziellen Wert „me“ kann der authentifizierte Nutzer angegeben werden.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort für die Methode „filters.list“.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "filter": [
    {
      object (Filter)
    }
  ]
}
Felder
filter[]

object (Filter)

Liste der Filter eines Nutzers.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/gmail.settings.basic
  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.