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 Methode filter.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.