Обзор API Gmail

API Gmail — это RESTful API, который можно использовать для доступа к почтовым ящикам Gmail и отправки писем. Для большинства веб-приложений API Gmail является наилучшим выбором для авторизованного доступа к данным пользователя Gmail и подходит для различных приложений, таких как:

  • Извлечение, индексирование и резервное копирование почты в режиме только для чтения.
  • Автоматическая или программная отправка сообщений
  • Миграция почтового аккаунта
  • Организация электронной почты, включая фильтрацию и сортировку сообщений.
  • Стандартизация электронных подписей в масштабах всей организации.

Общие термины

Ниже приведён список часто используемых терминов в этом API:

Делегатор и делегат
Делегатор — это пользователь Gmail, который предоставляет доступ к почтовому ящику другому пользователю в той же организации Google Workspace. Пользователь, получающий этот доступ, называется делегатом. Делегаты могут читать, отправлять и удалять сообщения, а также просматривать и добавлять контакты от имени своей учетной записи. Дополнительную информацию см. в разделе «Управление делегатами» .
Черновик
Неотправленное сообщение. Сообщение, содержащееся в черновике, можно заменить. Отправка черновика автоматически удаляет его и создает сообщение с системной меткой SENT . Черновик представлен ресурсом drafts . Для получения дополнительной информации см. раздел «Работа с черновиками» .
Фильтры
Для учетной записи настроены расширенные правила, которые оценивают входящие сообщения на соответствие определенным критериям (например, отправитель, тема или размер). При совпадении с критериями фильтры автоматически запускают такие действия, как добавление или удаление меток, или пересылка электронного письма на указанный адрес. Дополнительную информацию см. в разделе «Управление фильтрами» .
Адреса переадресации
Для автоматического пересыла сообщений с учетной записи пользователя необходимо настроить определенные, подтвержденные адреса электронной почты. Прежде чем адрес можно будет использовать в правиле или фильтре пересылки, его необходимо официально зарегистрировать и подтвердить, чтобы доказать право собственности. Дополнительную информацию см. в разделе «Управление пересылкой» .
Этикетка

Механизм для организации сообщений и веток обсуждения. Например, метка «налоги» может быть создана и применена ко всем сообщениям и веткам обсуждения, касающимся налогов пользователя. Для получения дополнительной информации см. раздел «Управление метками» .

Существует два типа этикеток:

Системные метки
Внутренне созданные метки, такие как INBOX , TRASH или SPAM . Эти метки нельзя удалить или изменить. Однако некоторые системные метки, например INBOX можно применять к сообщениям и веткам обсуждений или удалять из них.
Метки пользователя
Метки, созданные пользователем. Эти метки могут быть удалены или изменены пользователем или приложением. Пользовательская метка представлена ​​ресурсом labels .
Сообщение

Электронное письмо, содержащее отправителя, получателей, тему и текст сообщения. После создания сообщение изменить его нельзя. Сообщение представлено ресурсом messages .

Push-уведомления

Система уведомлений на стороне сервера, интегрированная с Google Cloud Pub/Sub. Приложения могут «отслеживать» почтовый ящик, и API Gmail будет автоматически отправлять веб-хуки или оповещения при каждом изменении (например, при получении нового письма), что избавляет приложение от необходимости постоянно опрашивать сервер на наличие обновлений. Для получения дополнительной информации см. Push-уведомления .

Сертификаты S/MIME

Цифровые сертификаты, загружаемые в определенные псевдонимы для отправки, позволяют пользователю отправлять зашифрованные электронные письма с цифровой подписью, обеспечивая безопасность сообщений и подлинность отправителя. Для получения дополнительной информации см. раздел «Управление сертификатами S/MIME» .

Псевдонимы для отправки

Это различные адреса электронной почты, с которых учетная запись имеет право отправлять письма. Каждая учетная запись имеет как минимум один псевдоним, представляющий основной адрес электронной почты. Псевдонимы соответствуют функции «Отправлять письма от имени» в веб-интерфейсе Gmail и также являются основой для настройки подписей электронной почты для каждого адреса. Для получения дополнительной информации см. раздел «Управление псевдонимами» .

Нить

Набор связанных сообщений, образующих диалог. В почтовом клиенте цепочка сообщений формируется, когда один или несколько получателей отвечают на сообщение своим собственным сообщением. Для получения дополнительной информации см. раздел «Управление цепочками сообщений» .