Gmail
Gmail — это веб-служба электронной почты из Google. С помощью соединителя Gmail можно выполнять такие действия, как отправка или получение сообщений электронной почты, а также активировать потоки новых сообщений электронной почты.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Стандарт | Все регионы Power Automate , кроме следующих: - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Стандарт | Все регионы Power Apps , кроме следующих: - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Стандарт | Все регионы Power Automate , кроме следующих: - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Microsoft |
| URL |
Поддержка Microsoft LogicApps Поддержка Microsoft Power Automate Поддержка Microsoft Power Apps |
| Метаданные соединителя | |
|---|---|
| Publisher | Microsoft |
| Website | https://mail.google.com/mail/ |
| Политика конфиденциальности | https://policies.google.com/privacy |
Проверка подлинности и создание собственного приложения
Соединитель Gmail теперь поддерживает несколько типов проверки подлинности:
- Использование общего приложения по умолчанию
- Создание собственного приложения
Общее приложение по умолчанию использует клиентское приложение Google, поддерживаемое корпорацией Майкрософт. В этом случае при входе в учетную запись Gmail вам будет предложено предоставить согласие на приложение Microsoft Power Platform .
С помощью параметра "Принести собственное приложение" вы можете использовать собственное клиентское приложение Google OAuth, а не управляемое корпорацией Майкрософт. Это позволит управлять разрешениями и включать определенные ограничения на использование соединителя.
Чтобы использовать собственное клиентское приложение Google OAuth с соединителем Gmail, вам потребуется выполнить следующие действия:
- Создание клиентского приложения OAuth с помощью консоли API Google
- Использование приложения в соединителе Gmail
Создание клиентского приложения OAuth в Google
Чтобы создать собственное клиентское приложение Google OAuth, необходимо сначала войти в https://developer.google.comсистему. Перейдите в консоль API Google , где можно управлять доступом к API Google и создавать приложение OAuth. Этот процесс описан в руководстве разработчика API Gmail Google. Google предоставляет средство настройки , которое поможет вам создать проект, включить API Gmail для проекта и создать клиентское приложение OAuth и учетные данные для него. Ниже приведены некоторые сведения, которые будут полезны при прохождении средства:
- При необходимости прочитайте и примите условия обслуживания.
- Выберите существующий проект, или средство создаст новый проект с именем "Мой проект".
- Это средство включает API Gmail в проекте.
- Средство попытается узнать нужный тип учетных данных. Вам потребуется получить клиентское приложение OAuth.
- Выберите API Gmail для API, который вы будете использовать (если вы еще не выбрали).
- Выберите веб-сервер для места вызова API.
- Выберите пользовательские данные для данных, к которые вы будете получать доступ.
- Это средство поможет вам настроить экран согласия OAuth.
- Выберите тип пользователя (внутренний или внешний). Если вы используете учетную запись потребителя Gmail, вы не можете выбрать "Внутренний".
- Укажите имя и, при необходимости, логотип приложения.
- Щелкните "Добавить область " и добавьте область Gmail (https://mail.google.com).
Замечание
В зависимости от необходимости использования можно выбрать соответствующее подмножество областей разрешений здесь.
- Добавьте azure-apim.net в качестве одного из авторизованных доменов.
Замечание
Это домен, на котором размещен соединитель Gmail, как определено здесь.
- При необходимости укажите другие сведения.
- Это средство позволит определить и добавить учетные данные клиента OAuth 2.0.
- Укажите имя клиентского приложения OAuth.
- Добавить "https://global.consent.azure-apim.net/redirect" для URI перенаправления.
После завершения перейдите к созданному клиенту OAuth на странице учетных данных. Вы найдете идентификатор клиента и секрет клиента приложения. Теперь эти значения можно использовать в подключении Gmail.
Использование собственного приложения в соединителе Gmail
После создания клиентского приложения Google OAuth его можно использовать при создании подключения Gmail.
- Выберите "Принести собственное приложение".
- Укажите значения идентификатора клиента и секрета клиента из приложения.
Нажмите кнопку "Войти" , чтобы войти в учетную запись Gmail. Вам будет предложено войти в учетную запись Gmail, а затем авторизовать доступ к созданному выше приложению Google.
Известные проблемы и ограничения
Ограничения триггера для большого количества входящих сообщений электронной почты
При поступлении нового триггера сообщения электронной почты могут пропускать сообщения электронной почты, если вы получаете более 300 сообщений электронной почты за 30 секунд. Рассмотрите возможность настройки потока с дополнительными параметрами фильтра, чтобы уменьшить количество сообщений электронной почты.
При поступлении нового триггера электронной почты может периодически пропускать сообщения электронной почты с вложениями, если вы используете учетную запись Google Workspace (ранее G Suite). Это происходит потому, что в некоторых случаях API Gmail занимает много времени для обработки сообщений электронной почты (возможно, из-за проверок безопасности вложений), поэтому сообщения электронной почты получаются с определенной задержкой.
В качестве возможного обходного решения попробуйте следующее:
Используйте крошечные сообщения электронной почты (без вложений), старайтесь отправлять их не так часто
Используйте другую учетную запись Gmail потребителя и настройте автоматическую пересылку из учетной записи Google Workspace в эту новую учетную запись Gmail потребителя. Настройте триггер для этой новой учетной записи. Так как это учетная запись потребителя, мы считаем, что задержка будет сведена к минимуму, и триггер не пропустит такие сообщения электронной почты.
Используйте настраиваемый соединитель для API ListMessage с параметром
q:Создайте действие для перечисления сообщений за последние 5 минут. Это можно сделать с помощью
qпараметра.qПример значения param —after:1649457986. Необходимо указатьcurrent time - 5minвремя эпохи в качестве входных данных действия.- 1649457986 эпоха времени, представляющего "пятница, 8 апреля 2022 г. 3:46:26 GMT-07:00".
Проверьте значение nextPageToken из ответа, пока не будет пустым. Если он не пуст, необходимо вызвать тот же API с
pageTokenзначением параметра, заданным для следующегоPageToken из ответа. Это можно сделать с помощью цикла "До" , например.Отфильтруйте идентификаторы этих сообщений, которые уже обработаны в предыдущих запусках (например, можно использовать соединитель хранилища таблиц Azure для хранения уже обработанных идентификаторов).
Использование действия получения сведений электронной почты для получения содержимого электронной почты по идентификатору
Использование соединителя Gmail с учетными записями Gmail для потребителей
В соответствии с политикой безопасности и конфиденциальности Google клиенты, использующие учетные записи потребителей Gmail (учетные записи заканчиваются @gmail.com и @googlemail.com) могут подключаться только к ограниченному набору служб в Power Automate и Logic Apps. Клиенты, использующие учетные записи Google Workspace (ранее G Suite), не влияют на это изменение. Если вам нужно использовать соединитель Gmail со службами, не указанными в приведенном ниже списке, необходимо зарегистрировать собственный идентификатор приложения в Google. Ниже приведен список текущих утвержденных служб, обратите внимание, что этот список подлежит изменению в будущем в соответствии с политиками Google:
- Службы Google: Gmail, Google Calendar, Google Contacts, Google Drive, Google Sheets, Google Tasks
- Встроенные действия и триггеры: control, AI Builder, операции с данными, дата и время, числовые функции, Power Agent, Power Apps, Request, Schedule, Text Functions, Переменные, Кнопка потока, Расположение
- Ограниченный набор служб Майкрософт: OneDrive, Sharepoint, Excel, Dynamics, Microsoft Teams, Office 365, SQL, SFTP и FTP
В Power Automate при создании потока с несоответствующей службой поток будет сохранен в отключенном состоянии.
Вычисление рабочих единиц
Соединитель имеет ограничение регулирования (см. здесь) на количество рабочих единиц, которые можно использовать в день.
Логика вычисления этих рабочих единиц для каждой операции показана ниже:
-
При поступлении нового сообщения : 10 + (5 * attachmentsCount);
- Если триггер возвращает новую электронную почту: 5 единиц для перечисления сообщений + 5 единиц, чтобы получить сообщение + 5 единиц * количество вложений.
- Если триггер не возвращает новое сообщение электронной почты: 5 единиц для перечисления сообщений.
- Отправка действия электронной почты (V2) : 100 единиц.
-
Ответ на действие электронной почты (V2) : 105 + (5 * вложенияCount);
- 5 единиц для получения исходного сообщения + 100 единиц для отправки сообщения ответа + 5 единиц * количество встроенных вложений в исходном сообщении.
- Для всех остальных действий: 10 единиц.
Подробное описание соединителя
Дополнительные сведения о соединителе см. в подробном разделе.
Общие ограничения
| Имя | Ценность |
|---|---|
| Максимальный размер почты (в МБ) | 35 |
| Максимальный размер вложений (в МБ) | 30 |
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| Принесите собственное приложение | Войдите с помощью собственного приложения Google. Дополнительные сведения см. в https://docs.microsoft.com/connectors/gmail/#authentication-and-bring-your-own-application. | Все регионы | Недоступен для совместного использования |
| Использование общего приложения по умолчанию | Войдите с помощью стандартного приложения Google. | Все регионы | Недоступен для совместного использования |
| По умолчанию [не рекомендуется] | Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости. | Все регионы | Недоступен для совместного использования |
Создание собственного приложения
Идентификатор auth: byoa
Применимо: все регионы
Войдите с помощью собственного приложения Google. Дополнительные сведения см. в https://docs.microsoft.com/connectors/gmail/#authentication-and-bring-your-own-application.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Идентификатор клиента | струна | Идентификатор клиента (или приложения) приложения Google | True |
| Секрет клиента | securestring | Секрет клиента приложения Google | True |
Использование общего приложения по умолчанию
Идентификатор проверки подлинности: shared-application
Применимо: все регионы
Войдите с помощью стандартного приложения Google.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
По умолчанию [не рекомендуется]
Применимо: все регионы
Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 60 | 60 секунд |
| Рабочие единицы в день | 90000 | 86400 секунд |
Действия
| Ответ на сообщение электронной почты (версия 2) |
Эта операция используется для ответа на определенное сообщение электронной почты. |
| Ответ на сообщение электронной почты [НЕ РЕКОМЕНДУЕТСЯ] |
Это действие устарело. Вместо этого используйте ответ на электронную почту (V2).
|
| Отправка электронной почты (версия 2) |
Эта операция используется для отправки сообщения электронной почты определенным получателям. |
| Отправка электронной почты [не рекомендуется] |
Это действие устарело. Вместо этого используйте отправку электронной почты (V2 ).
|
| Перемещение электронной почты в корзину |
Эта операция используется для перемещения определенного сообщения электронной почты в корзину. |
| Получение сведений о электронной почте |
Эта операция извлекает сведения о конкретном сообщении электронной почты. |
| Удаление электронной почты |
Эта операция используется для окончательного удаления определенного сообщения электронной почты. |
Ответ на сообщение электронной почты (версия 2)
Эта операция используется для ответа на определенное сообщение электронной почты.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сообщения
|
id | True | string |
Идентификатор сообщения электронной почты для ответа. |
|
Кому
|
To |
Пример: recipient1@domain.com; recipient2@domain.com |
||
|
КРЕДИТНАЯ КАРТА
|
Cc |
Пример: recipient1@domain.com; recipient2@domain.com |
||
|
BCC
|
Bcc |
Пример: recipient1@domain.com; recipient2@domain.com |
||
|
Тема
|
Subject | string |
Тема электронной почты (если она пуста, используется исходная тема). |
|
|
Тело
|
Body | html |
Содержание электронного письма. |
|
|
Ответить всем
|
ReplyAll | boolean |
True, чтобы ответить всем получателям. (по умолчанию: false) |
|
|
Важность
|
Importance | string |
Выберите важность. (по умолчанию: обычный) |
|
|
Имя
|
Name | True | string |
Заголовок вложения. |
|
Content
|
ContentBytes | True | byte |
Текст вложения. |
|
Тип контента
|
ContentType | string |
Тип содержимого в вложении. |
Ответ на сообщение электронной почты [НЕ РЕКОМЕНДУЕТСЯ]
Это действие устарело. Вместо этого используйте ответ на электронную почту (V2).
Эта операция используется для ответа на определенное сообщение электронной почты.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сообщения
|
id | True | string |
Идентификатор сообщения электронной почты для ответа. |
|
Кому
|
To |
Пример: recipient1@domain.com; recipient2@domain.com |
||
|
КРЕДИТНАЯ КАРТА
|
Cc |
Пример: recipient1@domain.com; recipient2@domain.com |
||
|
BCC
|
Bcc |
Пример: recipient1@domain.com; recipient2@domain.com |
||
|
Тема
|
Subject | string |
Тема электронной почты (если она пуста, используется исходная тема). |
|
|
Тело
|
Body | string |
Содержание электронного письма. |
|
|
Ответить всем
|
ReplyAll | boolean |
True, чтобы ответить всем получателям. (по умолчанию: false) |
|
|
Is HTML
|
IsHtml | boolean |
Значение true для отправки ответа в формате HTML. (по умолчанию: True) |
|
|
Важность
|
Importance | string |
Выберите важность. (по умолчанию: обычный) |
|
|
Имя
|
Name | True | string |
Заголовок вложения. |
|
Content
|
ContentBytes | True | byte |
Текст вложения. |
|
Тип контента
|
ContentType | string |
Тип содержимого в вложении. |
Отправка электронной почты (версия 2)
Эта операция используется для отправки сообщения электронной почты определенным получателям.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Кому
|
To | True |
Список допустимых адресов электронной почты, разделенных точкой с запятой или запятой. |
|
|
КРЕДИТНАЯ КАРТА
|
Cc |
Список допустимых адресов электронной почты, разделенных точкой с запятой или запятой. |
||
|
BCC
|
Bcc |
Список допустимых адресов электронной почты, разделенных точкой с запятой или запятой. |
||
|
Тема
|
Subject | string |
Тема исходящего сообщения электронной почты. |
|
|
Тело
|
Body | html |
Текст исходящего сообщения электронной почты. |
|
|
Важность
|
Importance | string |
Важность, связанная с сообщением электронной почты. |
|
|
Имя
|
Name | True | string |
Заголовок вложения. |
|
Content
|
ContentBytes | True | byte |
Текст вложения. |
|
Тип контента
|
ContentType | string |
Тип содержимого в вложении. |
Отправка электронной почты [не рекомендуется]
Это действие устарело. Вместо этого используйте отправку электронной почты (V2 ).
Эта операция используется для отправки сообщения электронной почты определенным получателям.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Кому
|
To | True |
Список допустимых адресов электронной почты, разделенных точкой с запятой или запятой. |
|
|
КРЕДИТНАЯ КАРТА
|
Cc |
Список допустимых адресов электронной почты, разделенных точкой с запятой или запятой. |
||
|
BCC
|
Bcc |
Список допустимых адресов электронной почты, разделенных точкой с запятой или запятой. |
||
|
Тема
|
Subject | string |
Тема исходящего сообщения электронной почты. |
|
|
Тело
|
Body | string |
Текст исходящего сообщения электронной почты. |
|
|
Is HTML
|
IsHtml | boolean |
Значение true для отправки сообщения электронной почты в формате HTML. (по умолчанию: True) |
|
|
Важность
|
Importance | string |
Важность, связанная с сообщением электронной почты. |
|
|
Имя
|
Name | True | string |
Заголовок вложения. |
|
Content
|
ContentBytes | True | byte |
Текст вложения. |
|
Тип контента
|
ContentType | string |
Тип содержимого в вложении. |
Перемещение электронной почты в корзину
Эта операция используется для перемещения определенного сообщения электронной почты в корзину.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сообщения
|
id | True | string |
Идентификатор сообщения электронной почты для перемещения в корзину. |
Получение сведений о электронной почте
Эта операция извлекает сведения о конкретном сообщении электронной почты.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сообщения
|
id | True | string |
Уникальный идентификатор сообщения электронной почты. |
|
Включение вложений
|
includeAttachments | boolean |
Если задано значение true, вложения также будут получены вместе с сообщением электронной почты. |
Возвращаемое значение
Сведения, связанные с определенным сообщением электронной почты.
Удаление электронной почты
Эта операция используется для окончательного удаления определенного сообщения электронной почты.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сообщения
|
id | True | string |
Идентификатор сообщения электронной почты для удаления. |
Триггеры
| Когда появится новое сообщение электронной почты |
Эта операция активируется при поступлении нового сообщения электронной почты, соответствующего указанным критериям. |
Когда появится новое сообщение электронной почты
Эта операция активируется при поступлении нового сообщения электронной почты, соответствующего указанным критериям.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Этикетка
|
label | string |
Выберите метку (по умолчанию: Входящие). |
|
|
Кому
|
to |
Список допустимых адресов электронной почты, разделенных точкой с запятой или запятой. |
||
|
От
|
from |
Пример: Sender1 | sender2@domain.com. |
||
|
Тема
|
subject | string |
Строка для поиска в теме. |
|
|
Важность
|
importance | string |
Значение true, если электронная почта должна быть важной. (по умолчанию: все). |
|
|
Усеянный
|
starred | string |
Значение True, если электронная почта должна быть в главной роли. (по умолчанию: все). |
|
|
Имеет вложения
|
fetchOnlyWithAttachments | boolean |
Значение true, чтобы получить только сообщения электронной почты с вложениями. |
|
|
Включение вложений
|
includeAttachments | boolean |
Значение true, чтобы получить вложения вместе с электронной почтой. |
Возвращаемое значение
Сведения, связанные с определенным сообщением электронной почты.
Определения
DetailedReceiveMessage
Сведения, связанные с определенным сообщением электронной почты.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
От
|
From |
Адрес электронной почты, из который отправлено сообщение. |
|
|
Имя отправителя
|
SenderName | string |
Имя отправителя электронной почты |
|
Кому
|
To |
Адрес электронной почты, на который отправлено сообщение. |
|
|
КРЕДИТНАЯ КАРТА
|
Cc |
Адреса электронной почты, содержащиеся в поле CC. |
|
|
BCC
|
Bcc |
Адреса электронной почты, содержащиеся в поле BCC. |
|
|
Тема
|
Subject | string |
Тема или раздел, связанные с сообщением электронной почты. |
|
Тело
|
Body | string |
Содержимое сообщения электронной почты. |
|
Обрезок
|
Snippet | string |
Короткая часть текста сообщения. |
|
Идентификаторы меток
|
LabelIds | array of string |
Список меток, связанных с сообщением электронной почты. |
|
Получено Date-Time
|
DateTimeReceived | date-time |
Пример:2017-05-03T20:08:57+00:00 |
|
Предполагаемый размер
|
EstimatedSize | integer |
Предполагаемый размер сообщения в байтах. |
|
Читается ли?
|
IsRead | boolean |
Значение true, если сообщение считывается; False в противном случае. |
|
Is HTML
|
IsHtml | boolean |
Значение True, если сообщение находится в формате HTML. |
|
Имеет вложения
|
HasAttachments | boolean |
Значение True, если сообщение содержит вложения. |
|
Attachments
|
Attachments | array of Attachment |
Список вложений в сообщение электронной почты. |
|
Идентификатор сообщения
|
Id | string |
Неизменяемый идентификатор сообщения. |
|
Идентификатор потока
|
ThreadId | string |
Идентификатор потока, к которому принадлежит сообщение. |
Вложение
Свойства вложения электронной почты.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Имя
|
Name | string |
Заголовок вложения. |
|
Content
|
ContentBytes | byte |
Текст вложения. |
|
Тип контента
|
ContentType | string |
Тип содержимого в вложении. |