Gmail API — это RESTful API, который можно использовать для доступа к почтовым ящикам Gmail и отправки почты. Для большинства веб-приложений Gmail API — оптимальный выбор для авторизованного доступа к данным пользователя Gmail и подходит для различных приложений, таких как:
- Извлечение, индексация и резервное копирование почты только для чтения
- Автоматическая или программная отправка сообщений
- Миграция учетной записи электронной почты
- Организация электронной почты, включая фильтрацию и сортировку сообщений
- Стандартизация подписей электронной почты в организации
Ниже приведен список общих терминов, используемых в API Gmail:
- Сообщение
- Сообщение электронной почты, содержащее отправителя, получателей, тему и текст. После создания сообщение не может быть изменено. Сообщение представлено ресурсом сообщения .
- Нить
- Совокупность связанных сообщений, образующих беседу. В почтовом клиенте цепочка сообщений формируется, когда один или несколько получателей отвечают на сообщение своим сообщением.
- Этикетка
Механизм организации сообщений и обсуждений. Например, метка «налоги» может быть создана и применена ко всем сообщениям и обсуждениям, связанным с налогами пользователя. Существует два типа меток:
- Системные метки
- Внутренне создаваемые метки, такие как
INBOX
,TRASH
илиSPAM
. Эти метки нельзя удалить или изменить. Однако некоторые системные метки, например,INBOX
можно применять к сообщениям и цепочкам сообщений или удалять из них. - Пользовательские метки
- Метки, созданные пользователем. Эти метки могут быть удалены или изменены пользователем или приложением. Пользовательская метка представлена ресурсом метки .
- Черновик
Неотправленное сообщение. Сообщение, содержащееся в черновике, можно заменить. Отправка черновика автоматически удаляет его и создаёт сообщение с системной меткой
SENT
. Черновик представлен ресурсом «черновик» .
Следующие шаги
Чтобы узнать больше о разработке с использованием API Google Workspace, включая обработку аутентификации и авторизации, ознакомьтесь с разделом Начало работы в качестве разработчика Google Workspace .
Чтобы узнать, как настроить и запустить простое приложение API Gmail, прочтите обзор Quickstarts .