Gmail API

API Gmail позволяет просматривать данные почтового ящика Gmail, такие как цепочки, сообщения и метки, и управлять ими.

Сервис: gmail.googleapis.com.

Для вызова этой службы мы рекомендуем использовать клиентские библиотеки Google. Если вашему приложению н��о����о��и��о использовать собственные библиотеки для вызова этой службы, используйте следующую информацию при отправке запросов API.

Документ открытия

Документ обнаружения — это машиночитаемая спецификация для описания и использования REST API. Он используется для создания клиентских библиотек, плагинов IDE и других инструментов, взаимодействующих с API Google. Одна служба может предоставлять несколько документов обнаружения. Эта служба предоставляет следующий документ обнаружения:

Конечная точка службы

Конечная точка службы — это базовый URL-адрес, указывающий сетевой адрес службы API. Одна служба может иметь несколько конечных точек службы. Эта служба имеет следующую конечную точку службы, и все приведенные ниже URI относятся к этой конечной точке службы:

  • https://gmail.googleapis.com

Ресурс REST: v1.users

Методы
getProfile GET /gmail/v1/users/{userId}/profile
Получает профиль Gmail текущего пользователя.
stop POST /gmail/v1/users/{userId}/stop
Прекратить получение push-уведомлений для данного почтового ящика пользователя.
watch POST /gmail/v1/users/{userId}/watch
Настройте или обновите отслеживание push-уведомлений для данного почтового ящика пользователя.

Ресурс REST: v1.users.drafts

Методы
create POST /gmail/v1/users/{userId}/drafts
POST /upload/gmail/v1/users/{userId}/drafts
Создает новый черновик с меткой DRAFT .
delete DELETE /gmail/v1/users/{userId}/drafts/{id}
Немедленно и навсегда удаляет указанный черновик.
get GET /gmail/v1/users/{userId}/drafts/{id}
Получает указанный черновик.
list GET /gmail/v1/users/{userId}/drafts
Перечисляет черновики в почтовом ящике пользователя.
send POST /gmail/v1/users/{userId}/drafts/send
POST /upload/gmail/v1/users/{userId}/drafts/send
Отправляет указанный существующий черновик получателям в заголовках To , Cc и Bcc .
update PUT /gmail/v1/users/{userId}/drafts/{id}
PUT /upload/gmail/v1/users/{userId}/drafts/{id}
Заменяет содержимое черновика.

Ресурс REST: v1.users.history

Методы
list GET /gmail/v1/users/{userId}/history
Выводит историю всех изменений в ��анно�� ��очтовом ящике.

Ресурс REST: v1.users.labels

Методы
create POST /gmail/v1/users/{userId}/labels
Создает новую метку.
delete DELETE /gmail/v1/users/{userId}/labels/{id}
Немедленно и навсегда удаляет указанную метку и удаляет ее из всех сообщений и цепочек, к которым она применена.
get GET /gmail/v1/users/{userId}/labels/{id}
Получает указанную метку.
list GET /gmail/v1/users/{userId}/labels
Перечисляет все метки в почтовом ящике пользователя.
patch PATCH /gmail/v1/users/{userId}/labels/{id}
Исправьте указанную метку.
update PUT /gmail/v1/users/{userId}/labels/{id}
Обновляет указанную метку.

Ресурс REST: v1.users.messages

Методы
batchDelete POST /gmail/v1/users/{userId}/messages/batchDelete
Удаляет множество сообщений по идентификатору сообщения.
batchModify POST /gmail/v1/users/{userId}/messages/batchModify
Изменяет метки указанных сообщений.
delete DELETE /gmail/v1/users/{userId}/messages/{id}
Немедленно и навсегда удаляет указанное сообщение.
get GET /gmail/v1/users/{userId}/messages/{id}
Получает указанное сообщение.
import POST /gmail/v1/users/{userId}/messages/import
POST /upload/gmail/v1/users/{userId}/messages/import
Импортирует сообщение только в почтовый ящик этого пользователя со стандартным сканированием и классификацией доставки электронной почты, аналогичным получению через SMTP.
insert POST /gmail/v1/users/{userId}/messages
POST /upload/gmail/v1/users/{userId}/messages
Непосредственно вставляет сообщение только в почтовый ящик этого пользователя, аналогично IMAP APPEND , минуя большую часть сканирования и классификации.
list GET /gmail/v1/users/{userId}/messages
Перечисляет сообщения в почтовом ящике пользователя.
modify POST /gmail/v1/users/{userId}/messages/{id}/modify
Изменяет метки указанного сообщения.
send POST /gmail/v1/users/{userId}/messages/send
POST /upload/gmail/v1/users/{userId}/messages/send
Отправляет указанное сообщение получателям в заголовках To , Cc и Bcc .
trash POST /gmail/v1/users/{userId}/messages/{id}/trash
Перемещает указанное сообщение в корзину.
untrash POST /gmail/v1/users/{userId}/messages/{id}/untrash
Удаляет указанное сообщение из корзины.

Ресурс REST: v1.users.messages.attachments

Методы
get GET /gmail/v1/users/{userId}/messages/{messageId}/attachments/{id}
Получает указанное вложение сообщения.

Ресурс REST: v1.users.settings

Методы
getAutoForwarding GET /gmail/v1/users/{userId}/settings/autoForwarding
Получает параметр автоматической переадресации для указанной учетной записи.
getImap GET /gmail/v1/users/{userId}/settings/imap
Получает настройки IMAP.
getLanguage GET /gmail/v1/users/{userId}/settings/language
Получает языковые настройки.
getPop GET /gmail/v1/users/{userId}/settings/pop
Получает настройки POP.
getVacation GET /gmail/v1/users/{userId}/settings/vacation
Получает настройки автоответчика.
updateAutoForwarding PUT /gmail/v1/users/{userId}/settings/autoForwarding
Обновляет настройку автоматической переадресации для указанной учетной записи.
updateImap PUT /gmail/v1/users/{userId}/settings/imap
Обновляет настройки IMAP.
updateLanguage PUT /gmail/v1/users/{userId}/settings/language
Обновляет языковые настройки.
updatePop PUT /gmail/v1/users/{userId}/settings/pop
Обновляет настройки POP.
updateVacation PUT /gmail/v1/users/{userId}/settings/vacation
Обновляет настройки автоответчика.

Ресурс REST: v1.users.settings.cse.identities

Методы
create POST /gmail/v1/users/{userId}/settings/cse/identities
Создает и настраивает идентификатор шифрования на стороне клиента, которому разрешено отправлять почту из учетной записи пользователя.
delete DELETE /gmail/v1/users/{userId}/settings/cse/identities/{cseEmailAddress}
Удаляет идентификатор шифрования на стороне клиента.
get GET /gmail/v1/users/{userId}/settings/cse/identities/{cseEmailAddress}
Получает конфигурацию удостоверения шифрования на стороне клиента.
list GET /gmail/v1/users/{userId}/settings/cse/identities
Перечисляет зашифрованные на стороне клиента удостоверения для аутентифицированного пользователя.
patch PATCH /gmail/v1/users/{userId}/settings/cse/identities/{emailAddress}
Связывает другую пару ключей с существующим идентификатором шифрования на стороне клиента.

Ресурс REST: v1.users.settings.cse.keypairs

Методы
create POST /gmail/v1/users/{userId}/settings/cse/keypairs
Создает и загружает цепочку сертификатов открытого ключа шифрования S/MIME на стороне клиента и метаданные закрытого ключа для аутентифицированного пользователя.
disable POST /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:disable
Отключает пару ключей шифрования на стороне клиента.
enable POST /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:enable
Включает пару ключей шифрования на стороне клиента, которая была отключена.
get GET /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}
Получает существующую пару ключей шифрования на стороне клиента.
list GET /gmail/v1/users/{userId}/settings/cse/keypairs
Перечисляет пары ключей шифрования на стороне клиента для аутентифицированного пользователя.
obliterate POST /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:obliterate
Удаляет пару ключей шифрования на стороне клиента навсегда и немедленно.

Ресурс REST: v1.users.settings.delegates

Методы
create POST /gmail/v1/users/{userId}/settings/delegates
Добавляет делегата со статусом проверки, установленным непосредственно на accepted , без отправки электронного письма с подтверждением.
delete DELETE /gmail/v1/users/{userId}/settings/delegates/{delegateEmail}
Удаляет указанный делегат (который может иметь любой статус проверки) и отменяет любую проверку, которая могла потребоваться для его использования.
get GET /gmail/v1/users/{userId}/settings/delegates/{delegateEmail}
Получает указанный делегат.
list GET /gmail/v1/users/{userId}/settings/delegates
Перечисляет делегатов для указанной учетной записи.

Ресурс REST: v1.users.settings.filters

Методы
create POST /gmail/v1/users/{userId}/settings/filters
Создает фильтр.
delete DELETE /gmail/v1/users/{userId}/settings/filters/{id}
Немедленно и навсегда удаляет указанный фильтр.
get GET /gmail/v1/users/{userId}/settings/filters/{id}
Получает фильтр.
list GET /gmail/v1/users/{userId}/settings/filters
Перечисляет фильтры сообщений пользователя Gmail.

Ресурс REST: v1.users.settings.forwardingAddresses.

Методы
create POST /gmail/v1/users/{userId}/settings/forwardingAddresses
Создает адрес пересылки.
delete DELETE /gmail/v1/users/{userId}/settings/forwardingAddresses/{forwardingEmail}
Удаляет указанный адрес пересылки и отменяет любую проверку, которая могла потребоваться.
get GET /gmail/v1/users/{userId}/settings/forwardingAddresses/{forwardingEmail}
Получает указанный адрес пересылки.
list GET /gmail/v1/users/{userId}/settings/forwardingAddresses
Перечисляет адреса пересылки для указанной учетной записи.

Ресурс REST: v1.users.settings.sendAs

Методы
create POST /gmail/v1/users/{userId}/settings/sendAs
Создает пользовательский псевдоним «Отправить как».
delete DELETE /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Удаляет указанный псевдоним отправки как.
get GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Получает указанный псевдоним отправки как.
list GET /gmail/v1/users/{userId}/settings/sendAs
Перечисляет псевдонимы отправки как для указанной учетной записи.
patch PATCH /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Исправьте указанный псевдоним отправки как.
update PUT /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Обновляет псевдоним отправки как.
verify POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/verify
Отправляет электронное письмо с подтверждением на указанный адрес псевдонима для отправки.

Ресурс REST: v1.users.settings.sendAs.smimeInfo

Методы
delete DELETE /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}
Удаляет указанную конфигурацию S/MIME для указанного псевдонима отправки.
get GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}
Получает указанную конфигурацию S/MIME для указанного псевдонима отправки как.
insert POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo
Вставьте (загрузите) данную конфигурацию S/MIME для указанного псевдонима отправки как.
list GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo
Перечисляет конфигурации S/MIME для указанного псевдонима отправки как.
setDefault POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}/setDefault
Устанавливает конфигурацию S/MIME по умолчанию для указанного псевдонима отправки как.

Ресурс REST: v1.users.threads

Методы
delete DELETE /gmail/v1/users/{userId}/threads/{id}
Немедленно и навсегда удаляет указанную тему.
get GET /gmail/v1/users/{userId}/threads/{id}
Получает указанный поток.
list GET /gmail/v1/users/{userId}/threads
Перечисляет потоки в почтовом ящике пользователя.
modify POST /gmail/v1/users/{userId}/threads/{id}/modify
Изменяет метки, примененные к потоку.
trash POST /gmail/v1/users/{userId}/threads/{id}/trash
Перемещает указанную тему в корзину.
untrash POST /gmail/v1/users/{userId}/threads/{id}/untrash
Удаляет указанную тему из корзины.