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