Ressource: Filter
Ressourcendefinition für Gmail-Filter. Filter gelten für bestimmte Nachrichten und nicht für eine ganze E-Mail-Konversation.
JSON-Darstellung |
---|
{ "id": string, "criteria": { object ( |
Felder | |
---|---|
id |
Die vom Server zugewiesene ID des Filters. |
criteria |
Übereinstimmungskriterien für den Filter. |
action |
Aktion, die der Filter ausführt. |
Kriterien
Kriterien für die Nachrichtenübereinstimmung.
JSON-Darstellung |
---|
{
"from": string,
"to": string,
"subject": string,
"query": string,
"negatedQuery": string,
"hasAttachment": boolean,
"excludeChats": boolean,
"size": integer,
"sizeComparison": enum ( |
Felder | |
---|---|
from |
Anzeigename oder E-Mail-Adresse des Absenders |
to |
Anzeigename oder E-Mail-Adresse des Empfängers Enthält Empfänger in den Headerfeldern „An“, „Cc“ und „Bcc“. Dazu können Sie einfach den lokalen Teil der E-Mail-Adresse verwenden. Beispiel: „beispiel“ und „beispiel@“ stimmen beide mit „beispiel@gmail.com“ überein. Bei diesem Feld wird die Groß-/Kleinschreibung nicht berücksichtigt. |
subject |
Im Betreff der Nachricht wurde eine Wortgruppe gefunden, bei der die Groß-/Kleinschreibung nicht berücksichtigt wird. Vorangestellte und nachgestellte Leerzeichen werden abgeschnitten und angrenzende Leerzeichen werden minimiert. |
query |
Gibt nur Nachrichten zurück, die der angegebenen Abfrage entsprechen. Unterstützt dasselbe Abfrageformat wie das Gmail-Suchfeld. Beispiel: |
negatedQuery |
Gibt nur Nachrichten zurück, die nicht mit der angegebenen Abfrage übereinstimmen. Unterstützt dasselbe Abfrageformat wie das Gmail-Suchfeld. Beispiel: |
hasAttachment |
Gibt an, ob die Nachricht einen Anhang enthält. |
excludeChats |
Gibt an, ob die Antwort Chats ausschließen soll. |
size |
Die Größe der gesamten RFC822-Nachricht in Byte, einschließlich aller Header und Anhänge. |
sizeComparison |
Gibt an, wie die Nachrichtengröße in Byte im Verhältnis zum Größenfeld stehen sollte. |
SizeComparison
Bestimmt, wie das Größenfeld mit der Nachrichtengröße verglichen werden soll.
Enums | |
---|---|
unspecified |
|
smaller |
Nachrichten suchen, die kleiner als die angegebene Größe sind. |
larger |
Nachrichten suchen, die größer sind als die angegebene Größe. |
Aktion
Eine Reihe von Aktionen, die für eine Nachricht ausgeführt werden sollen.
JSON-Darstellung |
---|
{ "addLabelIds": [ string ], "removeLabelIds": [ string ], "forward": string } |
Felder | |
---|---|
addLabelIds[] |
Liste der Labels, die der Nachricht hinzugefügt werden sollen. |
removeLabelIds[] |
Liste der Labels, die aus der Nachricht entfernt werden sollen. |
forward |
E-Mail-Adresse, an die die Nachricht weitergeleitet werden soll. |
Methoden |
|
---|---|
|
Erstellt einen Filter. |
|
Der angegebene Filter wird sofort und endgültig gelöscht. |
|
Ruft einen Filter ab. |
|
Listet die Nachrichtenfilter eines Gmail-Nutzers auf. |