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. Der spezielle Wert „me“ kann verwendet werden, um den authentifizierten Nutzer anzugeben.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort für die Filter.list-Methode.

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.