Вы можете искать и фильтровать файлы с помощью методов messages.list и threads.list . Эти методы принимают параметр q , который поддерживает практически тот же синтаксис расширенного поиска, что и веб-интерфейс Gmail. Список различий в поиске и фильтрации между пользовательским интерфейсом Gmail и API Gmail см. в статье «Различия в поисковых фильтрах: интерфейс Gmail и API Gmail» .
Этот расширенный синтаксис позволяет использовать поисковые запросы для фильтрации сообщений по таким свойствам, как отправитель, дата или метка, и это лишь некоторые из возможных вариантов. Например, следующий запрос извлекает все сообщения, отправленные пользователем в январе 2014 года:
GET https://www.googleapis.com/gmail/v1/users/me/messages?q=in:sent after:2014/01/01 before:2014/02/01
Помимо поисковых запросов, вы также можете фильтровать сообщения и обсуждения по меткам с помощью параметра labelIds . Это позволяет искать сообщения и обсуждения с указанными системными или пользовательскими метками. Подробнее см. в справочнике по методам messages.list или threads.list .
Различия в поиске и фильтрации: Gmail UI и Gmail API
Интерфейс Gmail выполняет расширение псевдонимов , что позволяет ему вывести псевдоним учётной записи из учётной записи Google Workspace. Например, предположим, что у вас есть учётная запись
myprimary@mycompany.net, и ваш администратор настроил для неё псевдонимmyalias@mycompany.net. Еслиmyalias@mycompany.netотправляет электронное письмо, но вы ищете «from: myprimary@mycompany.net)», письмо, отправленное сmyalias@mycompany.netотображается в результатах поиска в интерфейсе Gmail, но не в ответе API.Пользовательский интерфейс Gmail позволяет пользователям выполнять поиск по всему потоку сообщений, а вот API такой возможности не предоставляет.