Обзор 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 и также являются основой для настройки подписей электронной почты для каждого адреса. Для получения дополнительной информации см. раздел «Управление псевдонимами» .

Нить

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