REST Resource: users.settings.filters

Recurso: filtro

Definição de recurso para filtros do Gmail. Os filtros são aplicados a mensagens específicas, e não a uma conversa de e-mail inteira.

Representação JSON 
{
  "id": string,
  "criteria": {
    object (Criteria)
  },
  "action": {
    object (Action)
  }
}
Campos
id

string

O ID atribuído pelo servidor ao filtro.
criteria

object (Criteria)

Critérios de correspondência para o filtro.
action

object (Action)

Ação que o filtro realiza.

Critérios

Critérios de correspondência de mensagens.

Representação JSON 
{
  "from": string,
  "to": string,
  "subject": string,
  "query": string,
  "negatedQuery": string,
  "hasAttachment": boolean,
  "excludeChats": boolean,
  "size": integer,
  "sizeComparison": enum (SizeComparison)
}
Campos
from

string

O nome de exibição ou endereço de e-mail do remetente.
to

string

O nome de exibição ou endereço de e-mail do destinatário. Inclui destinatários nos campos de cabeçalho "para", "cc" e "bcc". Você pode usar apenas a parte local do endereço de e-mail. Por exemplo, "example" e "example@" correspondem a "example@gmail.com". Esse campo não diferencia maiúsculas de minúsculas.
subject

string

Frase sem distinção entre maiúsculas e minúsculas encontrada no assunto da mensagem. Os espaços em branco iniciais e finais são cortados, e os espaços adjacentes são condensados.
query

string

Retorna apenas mensagens que correspondem à consulta especificada. Suporta o mesmo formato de consulta da caixa de pesquisa do Gmail. Por exemplo, "from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread".
negatedQuery

string

Retorna apenas mensagens que não correspondem à consulta especificada. Suporta o mesmo formato de consulta da caixa de pesquisa do Gmail. Por exemplo, "from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread".
hasAttachment

boolean

Se a mensagem tem algum anexo.
excludeChats

boolean

Se a resposta deve excluir chats.
size

integer

O tamanho de toda a mensagem RFC822 em bytes, incluindo todos os cabeçalhos e anexos.
sizeComparison

enum (SizeComparison)

Como o tamanho da mensagem em bytes deve ser em relação ao campo de tamanho.

SizeComparison

Determina como o campo de tamanho deve ser comparado ao tamanho da mensagem.

Enums
unspecified
smaller Encontre mensagens menores do que o tamanho indicado.
larger Encontre mensagens maiores que o tamanho indicado.

Ação

Um conjunto de ações a serem realizadas em uma mensagem.

Representação JSON 
{
  "addLabelIds": [
    string
  ],
  "removeLabelIds": [
    string
  ],
  "forward": string
}
Campos
addLabelIds[]

string

Lista de marcadores a serem adicionados à mensagem.
removeLabelIds[]

string

Lista de marcadores a serem removidos da mensagem.
forward

string

Endereço de e-mail para onde a mensagem será encaminhada.

Métodos

create

 Cria um filtro.

delete

 Exclui o filtro especificado de forma imediata e permanente.

get

 Recebe um filtro.

list

 Lista os filtros de mensagens de um usuário do Gmail.