SendGrid
SendGrid 连接提供程序允许你发送电子邮件和管理收件人列表。
此连接器在以下产品和区域中可用：
| 服务 | Class | 区域 |
|---|---|---|
| Copilot Studio | 标准 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 逻辑应用程序 | 标准 | 除以下各项外的所有 逻辑应用区域 ： - Azure 中国区域 - 美国国防部（DoD） |
| Power Apps | 标准 | 除以下各项外的所有 Power Apps 区域 ： - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| Power Automate | 标准 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 联系人 | |
|---|---|
| Name | Microsoft |
| URL |
Microsoft LogicApps 支持 Microsoft Power Automate 支持 Microsoft Power Apps 支持 |
| 连接器元数据 | |
|---|---|
| 发布者 | Microsoft |
| 网站 | https://sendgrid.com/ |
| 隐私策略 | https://www.twilio.com/legal/privacy |
已知问题和限制
- SendGrid 附件不使用与其他连接器兼容的格式。 若要在提交附件时解决此问题，请为每个附件文件显式设置附件字段，如 Content、ContentType 和 Attachment File Name。
要求
- SendGrid 帐户和 SendGrid API 密钥，用于授权连接到 SendGrid 帐户
正在创建连接
连接器支持以下身份验证类型：
| 默认 | 用于创建连接的参数。 | 所有区域 | 可共享 |
违约
适用：所有区域
用于创建连接的参数。
这是可共享的连接。 如果 Power App 与其他用户共享，则连接也会共享。 有关详细信息，请参阅 画布应用的连接器概述 - Power Apps |Microsoft Docs
| Name | 类型 | Description | 必选 |
|---|---|---|---|
| SendGrid Api 密钥 | securestring | SendGrid Api 密钥 | True |
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 1200 | 60 秒 |
操作
| 从退回列表中删除电子邮件 |
从退回列表中删除电子邮件地址。 |
| 删除全局抑制 |
删除全局抑制 |
| 发送电子邮件 （V2） [已弃用] |
此作已弃用。 请改用发送电子邮件（V4）。
|
| 发送电子邮件 （V3） [已弃用] |
此作已弃用。 请改用发送电子邮件（V4）。
|
| 发送电子邮件（V4） |
发送电子邮件（V4）。 限制为 1000 个收件人。 |
| 将收件人添加到列表 |
将单个收件人添加到收件人列表。 |
| 检查电子邮件是否在未订阅的电子邮件列表中 |
检查电子邮件是否在未订阅的电子邮件列表中。 |
| 添加全局抑制 |
添加全局抑制 |
| 获取全局抑制 |
获取全局抑制 |
| 获取电子邮件的反弹 |
获取给定电子邮件地址的特定反弹。 |
从退回列表中删除电子邮件
从退回列表中删除电子邮件地址。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Email
|
True | string |
要删除的电子邮件。 |
删除全局抑制
删除全局抑制
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Email
|
True | string |
要删除的电子邮件。 |
发送电子邮件 （V2） [已弃用]
此作已弃用。 请改用发送电子邮件（V4）。
发送电子邮件（V2）。 限制为 1000 个收件人。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
来自
|
from | True |
电子邮件的发源地址。 必须是域的有效电子邮件地址 |
|
|
发件人名称
|
fromname | string |
电子邮件的发源名称 |
|
|
到
|
to | True |
用分号或逗号分隔的有效电子邮件地址 |
|
|
名称
|
toname | string |
用分号或逗号分隔的每个电子邮件地址的显示名称 |
|
|
Subject
|
subject | True | string |
电子邮件的主题 |
|
电子邮件正文
|
text | True | string |
电子邮件的内容 |
|
是 Html
|
ishtml | boolean |
指定电子邮件的内容是 HTML 还是纯文本 |
|
|
CC
|
cc |
用分号或逗号分隔的有效电子邮件地址 |
||
|
CC 名称
|
ccname | string |
用分号或逗号分隔的每个 CC 电子邮件地址的显示名称 |
|
|
Bcc
|
bcc |
用分号或逗号分隔的有效电子邮件地址 |
||
|
密件抄送名称
|
bccname | string |
每个 BCC 电子邮件地址的显示名称，用分号或逗号分隔 |
|
|
附件
|
file | byte |
附件文件内容 |
|
|
附件文件名
|
filename | string |
附件文件名 |
返回
- response
- object
发送电子邮件 （V3） [已弃用]
此作已弃用。 请改用发送电子邮件（V4）。
发送电子邮件（V3）。 限制为 1000 个收件人。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
来自
|
from | True |
电子邮件的发源地址。 必须是域的有效电子邮件地址 |
|
|
发件人名称
|
fromname | string |
电子邮件的发源名称 |
|
|
到
|
to | True |
用分号或逗号分隔的有效电子邮件地址 |
|
|
名称
|
toname | string |
用分号或逗号分隔的每个电子邮件地址的显示名称 |
|
|
Subject
|
subject | True | string |
电子邮件的主题 |
|
电子邮件正文
|
text | True | html |
电子邮件的内容 |
|
CC
|
cc |
用分号或逗号分隔的有效电子邮件地址 |
||
|
CC 名称
|
ccname | string |
用分号或逗号分隔的每个 CC 电子邮件地址的显示名称 |
|
|
Bcc
|
bcc |
用分号或逗号分隔的有效电子邮件地址 |
||
|
密件抄送名称
|
bccname | string |
每个 BCC 电子邮件地址的显示名称，用分号或逗号分隔 |
|
|
附件
|
file | byte |
附件文件内容 |
|
|
附件文件名
|
filename | string |
附件文件名 |
返回
- response
- object
发送电子邮件（V4）
发送电子邮件（V4）。 限制为 1000 个收件人。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Content
|
content | byte |
附件文件内容 |
|
|
Name
|
filename | string |
附件文件名 |
|
|
内容类型
|
contenttype | string |
附件中内容类型。 |
|
|
来自
|
from | True |
电子邮件的发源地址。 必须是域的有效电子邮件地址 |
|
|
发件人名称
|
fromname | string |
电子邮件的发源名称 |
|
|
到
|
to | True |
用分号或逗号分隔的有效电子邮件地址 |
|
|
名称
|
toname | string |
用分号或逗号分隔的每个电子邮件地址的显示名称 |
|
|
Subject
|
subject | True | string |
电子邮件的主题 |
|
电子邮件正文
|
text | True | html |
电子邮件的内容 |
|
CC
|
cc |
用分号或逗号分隔的有效电子邮件地址 |
||
|
CC 名称
|
ccname | string |
用分号或逗号分隔的每个 CC 电子邮件地址的显示名称 |
|
|
Bcc
|
bcc |
用分号或逗号分隔的有效电子邮件地址 |
||
|
密件抄送名称
|
bccname | string |
每个 BCC 电子邮件地址的显示名称，用分号或逗号分隔 |
返回
- response
- object
将收件人添加到列表
将单个收件人添加到收件人列表。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
列表 ID
|
listId | True | string |
收件人列表的唯一 ID。 |
|
收件人 ID
|
recipientId | True | string |
收件人的唯一 ID。 |
返回
- response
- object
检查电子邮件是否在未订阅的电子邮件列表中
检查电子邮件是否在未订阅的电子邮件列表中。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Email
|
True | string |
要检查的电子邮件。 |
返回
电子邮件未订阅响应
- 电子邮件未订阅响应
- EmailIsUnsubscribedResponse
添加全局抑制
添加全局抑制
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
收件人电子邮件
|
recipient_emails | array of string |
收件人电子邮件 |
返回
添加全局取消响应
获取全局抑制
获取全局抑制
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Email
|
True | string |
要检查的电子邮件。 |
返回
添加全局取消响应
获取电子邮件的反弹
定义
AddGlobalSuppressRequestAndResponse
添加全局取消响应
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
收件人电子邮件
|
recipient_emails | array of string |
收件人电子邮件 |
GetGlobalSuppressResponse
添加全局取消响应
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
收件人电子邮件
|
recipient_email | string |
收件人电子邮件 |
反弹
弹跳列表
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
物品
|
Bounce |
获取弹跳响应 |
EmailIsUnsubscribedResponse
电子邮件未订阅响应
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
是否取消订阅电子邮件
|
isUnsubscribed | boolean |
是否取消订阅电子邮件 |
弹跳
获取弹跳响应
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
已创建
|
created | integer |
已创建 |
|
Email
|
string |
|
|
|
原因
|
reason | string |
原因 |
|
状态
|
status | string |
状态 |
对象
这是类型“object”。