REST Resource: users.settings.filters

Risorsa: filtro

Definizione della risorsa 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 del filtro assegnato dal server.
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 nei campi di intestazione "A", "Cc" e "Ccn". Puoi utilizzare semplicemente la parte locale dell'indirizzo email. Ad esempio, "example" ed "example@" corrispondono entrambi a "example@gmail.com". Questo campo non fa distinzione tra maiuscole e minuscole.
subject

string

Nell'oggetto del messaggio è stata trovata una frase senza distinzione tra maiuscole e minuscole. Gli spazi vuoti iniziali e finali vengono tagliati e gli spazi 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

Indica se il messaggio ha allegati.
excludeChats

boolean

Indica se la risposta deve escludere le chat.
size

integer

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

enum (SizeComparison)

Indica come devono essere le dimensioni del messaggio in byte rispetto al campo delle dimensioni.

SizeComparison

Determina come il campo delle dimensioni deve essere confrontato con le dimensioni del messaggio.

Enum
unspecified
smaller Per trovare i 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 a cui deve essere inoltrato il messaggio.

Metodi

create

 Crea un filtro.

delete

 Elimina immediatamente e definitivamente il filtro specificato.

get

 Ottieni un filtro.

list

 Elenca i filtri dei messaggi di un utente Gmail.