В этом документе объясняется, как использовать фильтры в API Gmail.
С помощью ресурса settings.filters можно настроить расширенные правила фильтрации для учетной записи. Фильтры могут автоматически добавлять или удалять метки , а также пересылать электронные письма на подтвержденные псевдонимы на основе атрибутов или содержимого входящего сообщения.
Для получения информации о том, как создавать , отображать , получать или удалять фильтры Gmail, см. ресурс settings.filters .
Критерии соответствия
Фильтруйте сообщения по таким свойствам, как отправитель, тема, дата, размер и содержимое сообщения. Фильтры применяются только к конкретным сообщениям, а не ко всей цепочке писем. В качестве фильтра можно использовать любой запрос, использующий синтаксис расширенного поиска Gmail. Например, к распространенным шаблонам фильтров относятся:
| Фильтр | Матчи |
|---|---|
criteria.from='sender@example.com' | Электронные письма от sender@example.com |
criteria.size=10485760criteria.sizeComparison='larger' | Электронные письма размером более 10 МБ |
criteria.hasAttachment=true | Электронные письма с вложениями |
criteria.subject='[People with Pets]' | Электронные письма, в теме которых указано [People with Pets] |
criteria.query='"my important project"' | Электронные письма, содержащие информацию my important project |
criteria.negatedQuery='"secret knock"' | Электронные письма, не содержащие secret knock |
Если в фильтре присутствует несколько критериев, сообщение должно удовлетворять всем критериям, чтобы фильтр был применен.
Действия
Примените Action к сообщениям, соответствующим критериям фильтра. С помощью Action вы можете пересылать сообщения на подтвержденный адрес электронной почты, а также добавлять и удалять метки .
Добавляйте или удаляйте метки, чтобы изменить статус электронного письма. Например, к распространенным действиям относятся:
| Действие | Эффект |
|---|---|
action.removeLabelIds=['INBOX'] | Архивируйте электронные письма (пропускайте входящие). |
action.removeLabelIds=['UNREAD'] | Отметить как прочитанное |
action.removeLabelIds=['SPAM'] | Никогда не помечайте сообщения как спам. |
action.removeLabelIds=['IMPORTANT'] | Никогда не отмечайте как важный |
action.addLabelIds=['IMPORTANT'] | Отметьте как важное |
action.addLabelIds=['TRASH'] | Удалите электронное письмо |
action.addLabelIds=['STARRED'] | Отметить как понравившееся |
action.addLabelIds=['<user label id>'] | Помечайте письма пользовательской меткой. Для каждого фильтра допускается только одна пользовательская метка. |
Примеры кода
Приведенные ниже примеры кода демонстрируют, как помечать и архивировать сообщения из списка рассылки: