Вы можете искать или фильтровать файлы, используя методы messages.list и threads.list . Эти методы принимают параметр q , который поддерживает большую часть того же синтаксиса расширенного поиска , что и веб-интерфейс Gmail. Список различий в поиске и фильтрах между пользовательским интерфейсом Gmail и API Gmail см. в разделе Различия в поисковых фильтрах: пользовательский интерфейс Gmail и Gmail API .
Этот расширенный синтаксис позволяет использовать поисковые запросы для фильтрации сообщений по таким свойствам, как отправитель, дата или метка, чтобы указать несколько возможностей. Например, следующий запрос извлекает все сообщения, отправленные пользователем в январе 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 этого не делает.