Вы можете искать и фильтровать файлы с помощью методов 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. Например, предположим, что у вас есть учётная запись
[email protected], и ваш администратор настроил для неё псевдоним[email protected]. Если[email protected]отправляет электронное письмо, но вы ищете «from: [email protected])», письмо, отправленное с[email protected]отображается в результатах поиска в интерфейсе Gmail, но не в ответе API.Пользовательский интерфейс Gmail позволяет пользователям выполнять поиск по всему потоку сообщений, а вот API такой возможности не предоставляет.