REST Resource: users.settings.filters

Risorsa: filtro

Definizione delle risorse per i filtri di Gmail. I filtri vengono applicati a messaggi specifici anziché a un intero thread di email.

Rappresentazione JSON
{
  "id": string,
  "criteria": {
    object (Criteria)
  },
  "action": {
    object (Action)
  }
}
Campi
id

string

L'ID assegnato dal server del filtro.

criteria

object (Criteria)

Criteri di corrispondenza per il filtro.

action

object (Action)

Azione eseguita dal filtro.

Criteri

Criteri di corrispondenza dei messaggi.

Rappresentazione JSON
{
  "from": string,
  "to": string,
  "subject": string,
  "query": string,
  "negatedQuery": string,
  "hasAttachment": boolean,
  "excludeChats": boolean,
  "size": integer,
  "sizeComparison": enum (SizeComparison)
}
Campi
from

string

Il nome visualizzato o l'indirizzo email del mittente.

to

string

Il nome visualizzato o l'indirizzo email del destinatario. Include i destinatari in "a", "Cc" e "Ccn" campi di intestazione. Puoi utilizzare semplicemente la parte locale dell'indirizzo email. Ad esempio, "example" ed "example@" entrambi corrispondono a "example@gmail.com". Questo campo non fa distinzione tra maiuscole e minuscole.

subject

string

Nell'oggetto del messaggio è stata rilevata una frase senza distinzione tra maiuscole e minuscole. Gli spazi vuoti finali e iniziali vengono tagliati e quelli adiacenti vengono compressi.

query

string

Restituisci solo i messaggi che corrispondono alla query specificata. Supporta lo stesso formato di query della casella di ricerca di Gmail. Ad esempio, "from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread".

negatedQuery

string

Restituisci solo i messaggi che non corrispondono alla query specificata. Supporta lo stesso formato di query della casella di ricerca di Gmail. Ad esempio, "from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread".

hasAttachment

boolean

Se il messaggio ha allegati.

excludeChats

boolean

Indica se la risposta deve escludere le chat.

size

integer

Le dimensioni dell'intero messaggio RFC822 in byte, incluse tutte le intestazioni e gli allegati.

sizeComparison

enum (SizeComparison)

Il modo in cui le dimensioni del messaggio in byte devono essere in relazione al campo delle dimensioni.

SizeComparison

Determina come confrontare il campo delle dimensioni con le dimensioni del messaggio.

Enum
unspecified
smaller Per trovare messaggi di dimensioni inferiori a quelle specificate:
larger Per trovare i messaggi di dimensioni superiori a quelle specificate:

Azione

Un insieme di azioni da eseguire su un messaggio.

Rappresentazione JSON
{
  "addLabelIds": [
    string
  ],
  "removeLabelIds": [
    string
  ],
  "forward": string
}
Campi
addLabelIds[]

string

Elenco di etichette da aggiungere al messaggio.

removeLabelIds[]

string

Elenco di etichette da rimuovere dal messaggio.

forward

string

Indirizzo email al quale deve essere inoltrato il messaggio.

Metodi

create

Crea un filtro.

delete

Elimina immediatamente e definitivamente il filtro specificato.

get

Ottiene un filtro.

list

Elenca i filtri dei messaggi di un utente Gmail.