REST Resource: users.settings.filters

Recurso: filtro

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

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

string

O servidor atribuiu o ID do filtro.

criteria

object (Criteria)

Critérios de correspondência do filtro.

action

object (Action)

Ação que o filtro executa.

Critérios

A mensagem corresponde aos critérios.

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 o endereço de e-mail do remetente.

to

string

O nome de exibição ou o endereço de e-mail do destinatário. Inclui destinatários em "Para", "Cc" e "Cco" . Você pode usar simplesmente a parte local do endereço de e-mail. Por exemplo, "exemplo" e "exemplo@" ambos correspondem a "example@gmail.com". Esse campo não diferencia maiúsculas de minúsculas.

subject

string

Foi encontrada uma frase que não diferencia maiúsculas de minúsculas no assunto da mensagem. Os espaços em branco à direita e à esquerda são recortados e os espaços adjacentes são recolhidos.

query

string

Mostra apenas mensagens que correspondam à consulta especificada. Compatível com 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

Mostra apenas mensagens que não correspondem à consulta especificada. Compatível com 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 que o tamanho especificado.
larger Encontre mensagens maiores que o tamanho informado.

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 o qual a mensagem deve ser encaminhada.

Métodos

create

Cria um filtro.

delete

Exclui de forma imediata e permanente o filtro especificado.

get

Recebe um filtro.

list

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