Вы можете искать или фильтровать файлы, используя методы 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 и API Gmail.
Пользовательский интерфейс Gmail выполняет расширение псевдонимов , что позволяет ему определять псевдоним учетной записи из учетной записи Google Workspace. Например, предположим, у вас есть учетная запись
myprimary@mycompany.net, и ваш администратор создает для этой учетной записи псевдонимmyalias@mycompany.net. Еслиmyalias@mycompany.netотправляет электронное письмо, но вы ищете "from: myprimary@mycompany.net)", то электронное письмо, отправленноеmyalias@mycompany.net, отображается в результатах поиска в пользовательском интерфейсе Gmail, но не в ответе API.Пользовательский интерфейс Gmail позволяет выполнять поиск по всей ветке обсуждения, но API такой возможности не предоставляет.