Outlook.com

Outlook.com 连接器允许管理邮件、日历和联系人。 可以执行各种作,例如发送邮件、安排会议、添加联系人等。

此连接器在以下产品和区域中可用:

服务 Class 区域
Copilot Studio 标准 除以下各项外的所有 Power Automate 区域
     - 由世纪互联运营的中国云
逻辑应用程序 标准 除以下各项外的所有 逻辑应用区域
     - 美国国防部(DoD)
Power Apps 标准 除以下各项外的所有 Power Apps 区域
     - 由世纪互联运营的中国云
Power Automate 标准 除以下各项外的所有 Power Automate 区域
     - 由世纪互联运营的中国云
连接器元数据
发布者 Microsoft

先决条件

  • 访问邮箱已启用 REST API 的 Outlook.com 电子邮件帐户。 如果收到错误,请检查是否已启用 REST API。

    重要

    由于安全策略,此连接器不再支持企业帐户和Microsoft工作帐户,例如 @<domain.onmicrosoft.com>。 请改用 Office 365 Outlook 连接器,该连接器的功能与 Outlook.com 连接器相同。 尽管现有企业连接将持续一段时间工作,但不允许使用新连接。 Microsoft了解切换连接器并不简单。 但是,需要此限制才能为客户提供更好的安全控制。 连接尝试连接到专用本地邮件服务器、沙盒帐户或测试帐户上的帐户也可能会导致错误。

创建连接

当系统提示你创建连接时,请选择 “登录”,提供 Outlook 帐户凭据,然后按照其余提示完成连接。

若要在作中向电子邮件正文添加超链接,请执行以下步骤:

  1. Body 参数中,突出显示要链接的文本。 在编辑器工具栏上,选择“ 链接”。
  2. “链接目标” 参数中,粘贴链接地址,然后选择“ 添加”。
  3. 若要确认,请将指针移到新超链接上。 出现外部链接图标时,选择该图标以打开链接页。

SMTP 标头

连接器附加以下 SMTP 标头(Internet 邮件头)以及每个已发送电子邮件的值:

  • “x-ms-mail-application”

    服务 价值
    Power Automate Microsoft Power Automate;User-Agent:azure-logic-apps/1.0(工作流 <工作流 ID>;版本 <ID>) microsoft-flow/1.0
    Power Apps Microsoft Power Apps;用户代理:PowerApps/<版本 ID> (<播放器类型>;AppName=<app name>)
    Azure Logic Apps Azure 逻辑应用;User-Agent:azure-logic-apps/1.0(工作流 <工作流 ID>;版本 <ID>)
  • “x-ms-mail-operation-type”

    Description 价值
    对于答复电子邮件作 答复
    转发电子邮件作 向前
    用于发送电子邮件作,包括 SendEmailWithOptionsSendApprovalEmail 发送
  • 值为Environment Id“x-ms-mail-environment-id”

    此标头基于所使用的服务存在:

    服务 存在
    Power Apps 始终存在
    Power Automate 仅在新连接中存在
    Azure Logic Apps 永不存在
  • 具有以下值的“x-ms-mail-workflow”

    服务 价值
    Power Automate x-ms-workflow-name: <workflow name>; x-ms-workflow-run-id: <workflow run id>; x-ms-client-request-id: <client request id>;
    Power Apps x-ms-client-request-id: <客户端请求 ID>;
    Azure Logic Apps x-ms-workflow-name: <workflow name>; x-ms-workflow-run-id: <workflow run id>; x-ms-client-request-id: <client request id>;

常规已知问题和限制

  • 连接器超时

    Outlook.com 连接器将出站请求发送到 Outlook REST API,每个外部请求的超时间隔为 60 秒。 如果达到此外部请求限制,将返回以下错误:

    { "status": 504, "message": "Request failed. Try again later"}

    除非在 Power Automate 和 Azure 逻辑应用中更改默认重试策略,否则此类失败的请求最多重试 4 次。 有关详细信息,请参阅 Azure 逻辑应用中处理错误和异常

    注释

    返回 504 (gateway timeout) 的状态代码并不意味着基础作失败。 应用默认重试策略后,可以多次运行相同的作。 例如,如果 “发送电子邮件”(V2) 作导致 504 响应,该作会重试请求,因此可以重复的电子邮件。

  • 附件

    • 某些附件类型(如 EML、MSG 和 ICS)目前支持有限。 处理电子邮件时,连接器将跳过这些附件。
    • 某些触发器和作具有 Include Attachments 参数,用于控制何时在响应中包含任何附件内容。 此参数仅控制附件 的内容,而不是附件的元数据,如 ID、名称、内容类型、大小、Is Inline 等,这些元数据包含在响应中,而不考虑参数的值。
    • 对于内联嵌入图像,每个数据 URI 限制为 1MB,即在 base64 编码后图像不能超过 1MB。 这仅适用于邮件正文中的嵌入图像。
  • 文件夹名称

    Folder 参数中,对于自定义输入值,文件夹名称不支持正斜杠符号 / 。 解决方法是使用文件选取器,或提供文件夹 ID 值。

  • 共享邮箱

    如果收到错误 Specified object was not found in the store,请尝试以下作:

    • 检查邮件帐户权限。
    • 检查触发器中指定的邮件帐户是否为共享邮箱的成员。
    • 在管理员中心检查共享邮箱配置。
    • 请尝试删除并重新创建 Outlook 连接。

    当邮箱所有者移动或删除邮件时,也会出现此错误。

作的已知问题和限制

简短说明 Operations 详细说明
不支持使用加密电子邮件答复 答复电子邮件 (V3) 此作不支持加密的电子邮件。 如果答复启用了加密的电子邮件,将收到请求失败的错误。
可作邮件与 HTML 内容之间的行为差异 发送审批电子邮件
使用选项发送电子邮件
这些作发送可作邮件(作卡片)以及 HTML 内容。

- 仅当在可作邮件中选择按钮而不是 HTML 内容时,才会本地化响应。

- 在主权云中,为所有收件人呈现 HTML 内容。 但是,可作邮件仅呈现给电子邮件的发件人,而不适用于其他收件人。
使用 EWS 创建的事件的更新或删除作不起作用 更新事件 (V3)
删除事件
使用 EWS 服务创建的旧事件 ID 包含正斜杠(/),它们不适用于图形 API 更新和删除,因为它们会导致图形 API 错误路由和引发错误。

触发器的已知问题和限制

简短说明 Operations 详细说明
可能发生罕见的延迟 新电子邮件到达时(V2)
当一封提及我的新电子邮件到达时 (V2)
标记电子邮件时(V2)
添加、更新或删除事件时(V2)
在大多数情况下,当发生相应事件时,触发器几乎立即触发。 但是,在极少数情况下,触发器延迟可能需要长达一小时。
跳过上次成功运行之前收到的电子邮件 新电子邮件到达时(V2)
当一封提及我的新电子邮件到达时
这些触发器根据收到电子邮件的日期和时间触发。 将电子邮件移动到另一个文件夹不会更改收到的日期属性值,这意味着这些触发器将跳过上次成功运行之前收到的任何电子邮件。
触发与标记或标记电子邮件相关的任何事件 标记电子邮件时 此触发器在标记电子邮件、接收已标记的电子邮件或以任何方式更改已标记的电子邮件时触发,例如,更改电子邮件类别或答复电子邮件。

常规限制

Name 价值
最大邮件内容长度(以 MB 为单位) 50
选项和审批邮件的最大选项数 100
同时从连接器传输的最大兆字节数 300
连接器并发处理的最大请求数 30

限制

名称 调用 续订期
每个连接的 API 调用数 300 60 秒

操作

使用选项发送电子邮件

此作发送一封电子邮件,其中包含多个选项,并等待收件人使用其中一个选项进行回复。 有关支持不同邮件客户端中的可作邮件,请参阅以下链接: https://docs.microsoft.com/outlook/actionable-messages/#outlook-version-requirements-for-actionable-messages

创建事件 (V1) [已弃用]

此作已弃用。 请改用“创建”事件(V3)。

此作在日历中创建一个新事件。 (V1)

创建事件 (V2) [已弃用]

此作已弃用。 请改用“创建”事件(V3)。

此作在日历中创建一个新事件。 (V2)

创建事件 (V3)

此作在日历中创建一个新事件。

创建联系人

此作在联系人文件夹中创建新的联系人。

删除事件

此作删除日历中的事件。

删除电子邮件

此作按 ID 删除电子邮件。

删除联系人

此作从联系人文件夹中删除联系人。

发送批准电子邮件

此作发送审批电子邮件,并等待收件人的响应。 有关支持不同邮件客户端中的可作邮件,请参阅以下链接: https://docs.microsoft.com/outlook/actionable-messages/#outlook-version-requirements-for-actionable-messages

发送电子邮件 [已弃用]

此作已弃用。 请改用发送电子邮件(V2)。

此作会发送电子邮件。

发送电子邮件(V2)

此作会发送电子邮件。

响应事件邀请

响应事件邀请。

回复电子邮件 [已弃用]

此作已弃用。 请改用答复电子邮件(V3)。

此作答复电子邮件。

更新事件 (V1) [已弃用]

此作已弃用。 请改用 更新事件(V3 )。

此作更新日历中的事件。 (V1)

更新事件 (V2) [已弃用]

此作已弃用。 请改用 更新事件(V3 )。

此作更新日历中的事件。 (V2)

更新事件 (V3)

此作更新日历中的事件。

更新联系人

此作更新联系人文件夹中的联系人。

标记为已读

此作将电子邮件标记为已阅读。

标记电子邮件

此作标记电子邮件。

移动电子邮件

此作将电子邮件移动到指定文件夹。

答复电子邮件 (V2) [已弃用]

此作已弃用。 请改用答复电子邮件(V3)。

此作答复电子邮件。

答复电子邮件 (V3)

此作答复电子邮件。

获取事件 (V1) [已弃用]

此作已弃用。 请改用 Get 事件 (V2)。

此作从日历中获取特定事件。 (V1)

获取事件 (V1) [已弃用]

此作已弃用。 请改用 Get 事件(V3)。

此作从日历获取事件。 (V1)

获取事件 (V2)

此作从日历中获取特定事件。 (V2)

获取事件 (V2) [已弃用]

此作已弃用。 请改用 Get 事件(V3)。

此作从日历获取事件。 (V2)

获取事件 (V3)

此作从日历获取事件。 (V3)

获取事件的日历视图 [已弃用]

此作已弃用。 请改用 事件(V2)的日历视图

获取事件的日历视图。

获取事件的日历视图 (V2)

此作获取日历中的所有事件(包括重复周期实例)。 (V2)

获取日历

此作列出了可用的日历。

获取电子邮件

此作按 ID 获取电子邮件。

获取电子邮件 [已弃用]

此作已弃用。 请改用“获取电子邮件”(V2)。

此作从文件夹获取电子邮件。

获取电子邮件 (V2)

此作从文件夹获取电子邮件。

获取联系人

此作从联系人文件夹中获取特定联系人。

获取联系人

此作从联系人文件夹中获取联系人。

获取联系人文件夹

此作列出了可用的联系人文件夹。

获取附件

此作按 ID 获取电子邮件附件。

转发电子邮件

转发电子邮件。

使用选项发送电子邮件

此作发送一封电子邮件,其中包含多个选项,并等待收件人使用其中一个选项进行回复。 有关支持不同邮件客户端中的可作邮件,请参阅以下链接: https://docs.microsoft.com/outlook/actionable-messages/#outlook-version-requirements-for-actionable-messages

参数

名称 密钥 必需 类型 说明
To True email

指定用分号分隔的电子邮件地址,例如 someone@contoso.com

Subject
Subject string

电子邮件的主题

用户选项
Options string

电子邮件响应的逗号分隔选项列表

标题文本
HeaderText string

电子邮件正文的标题文本

选择文本
SelectionText string

用户选项选择的标题文本

Body
Body string

电子邮件正文

重要性
Importance string

重要性

Name
Name True string

附件名称

Content
ContentBytes True byte

附件内容

仅使用 HTML 消息
UseOnlyHTMLMessage boolean

仅使用 HTML 消息

隐藏 HTML 消息
HideHTMLMessage boolean

如果设置为“是”,则电子邮件正文处于隐藏状态,并且仅显示消息卡。 不支持可作邮件的电子邮件客户端将显示 HTML 消息,而不考虑参数值。

显示 HTML 确认对话框
ShowHTMLConfirmationDialog boolean

如果设置为“是”,则会显示一个对话框,以确认所选 HTML 邮件选项

返回

审批电子邮件响应

创建事件 (V1) [已弃用]

此作已弃用。 请改用“创建”事件(V3)。

此作在日历中创建一个新事件。 (V1)

参数

名称 密钥 必需 类型 说明
日历 ID
table True string

选择日历

Id
Id string

事件的唯一标识符

响应
Response string
Time
Time date-time
类型
Type string
Name
Name string
地址
Address email
内容类型
ContentType string
Content
Content string
正文预览
BodyPreview string

与事件关联的消息预览

类别
Categories array of string

与事件关联的类别

更改密钥
ChangeKey string

此属性标识事件对象的版本。 每次更改事件时,ChangeKey 也会更改。

创建时间
DateTimeCreated date-time

创建事件的日期和时间

上次修改时间
DateTimeLastModified date-time

上次修改事件的日期和时间

结束时间
End True date-time

事件的结束时间

结束时区
EndTimeZone string

此属性指定会议结束时间的时区。 该值必须在 Windows 中定义(例如:“太平洋标准时间”)。

是否有附件?
HasAttachments boolean

如果事件具有附件,则设置为 true

事件唯一 ID
ICalUId string

由不同日历中事件的所有实例共享的唯一标识符

重要性
Importance string

事件的重要性:低、正常或高

全天事件吗?
IsAllDay boolean

如果事件持续一整天,则设置为 true

是否已取消?
IsCancelled boolean

如果事件已取消,则设置为 true

是组织者
IsOrganizer boolean

如果邮件发件人也是组织者,则设置为 true

显示名称
DisplayName string
街道
Street string
City
City string
State
State string
CountryOrRegion
CountryOrRegion string
邮政编码
PostalCode string
Altitude
Altitude double
Latitude
Latitude double
Longitude
Longitude double
准确性
Accuracy double
AltitudeAccuracy
AltitudeAccuracy double
Name
Name string
地址
Address email
类型
Type string
时间间隔
Interval integer
月份
Month integer
DayOfMonth
DayOfMonth integer
DaysOfWeek
DaysOfWeek array of string
FirstDayOfWeek
FirstDayOfWeek string
Index
Index string
类型
Type string
开始日期
StartDate date-time
结束日期
EndDate date-time
NumberOfOccurrences
NumberOfOccurrences integer
提醒
Reminder integer

事件开始前几分钟的时间提醒

请求的响应
ResponseRequested boolean

如果发送方希望在接受或拒绝事件时收到响应,则设置为 true

响应
Response string
Time
Time date-time
系列主 ID
SeriesMasterId string

Series Master 事件类型的唯一标识符

显示为
ShowAs string

显示为忙或忙

开始时间
Start True date-time

事件的开始时间

开始时区
StartTimeZone string

此属性指定会议开始时间的时区。 该值必须在 Windows 中定义(例如:“太平洋标准时间”)。

Subject
Subject True string

事件主题

类型
Type string

事件类型:单个实例、事件、异常或系列主控形状

Web 链接
WebLink uri

与事件关联的消息预览

原因
Reason string

O365 同步事件协议使用的原因属性,如果是已删除的事件,将“删除”。

返回

后端的连接器特定的日历事件模型类

创建事件 (V2) [已弃用]

此作已弃用。 请改用“创建”事件(V3)。

此作在日历中创建一个新事件。 (V2)

参数

名称 密钥 必需 类型 说明
日历 ID
table True string

选择日历

Subject
Subject True string

事件主题

开始时间
Start True date-time

事件的开始时间(例如:“2016-11-01T14:30:00Z”)

结束时间
End True date-time

事件的结束时间(例如:“2016-11-01T15:30:00Z”)

时区
TimeZone string

事件的时区

所需的与会者
RequiredAttendees email

活动所需的与会者,以分号分隔

可选与会者
OptionalAttendees email

活动(以分号分隔)的可选与会者

资源与会者
ResourceAttendees string

以分号分隔的事件的资源与会者

Body
Body string

与事件关联的消息正文

是 HTML
IsHtml boolean

如果正文为 Html,则设置为 true

位置
Location string

事件的位置

重要性
Importance string

事件的重要性:低、正常或高

全天事件吗?
IsAllDay boolean

如果事件持续一整天,则设置为 true

Recurrence
Recurrence string

事件的重复模式

定期结束时间
RecurrenceEnd date-time

重复周期的结束时间

出现次数
NumberOfOccurrences integer

重复事件的次数

提醒
Reminder integer

事件开始前几分钟的时间提醒

显示为
ShowAs string

事件期间要显示的状态

请求的响应
ResponseRequested boolean

如果发送方希望在接受或拒绝事件时收到响应,则设置为 true

返回

客户端的连接器特定日历事件模型类

创建事件 (V3)

此作在日历中创建一个新事件。

参数

名称 密钥 必需 类型 说明
日历 ID
table True string

选择日历

Subject
Subject True string

事件主题

开始时间
Start True date-time

事件的开始时间(例如:“2016-11-01T14:30:00Z”)

结束时间
End True date-time

事件的结束时间(例如:“2016-11-01T15:30:00Z”)

时区
TimeZone string

事件的时区

所需的与会者
RequiredAttendees email

活动所需的与会者,以分号分隔

可选与会者
OptionalAttendees email

活动(以分号分隔)的可选与会者

资源与会者
ResourceAttendees string

以分号分隔的事件的资源与会者

Body
Body html

与事件关联的消息正文

位置
Location string

事件的位置

重要性
Importance string

事件的重要性:低、正常或高

全天事件吗?
IsAllDay boolean

如果事件持续一整天,则设置为 true

Recurrence
Recurrence string

事件的重复模式

定期结束时间
RecurrenceEnd date-time

重复周期的结束时间

出现次数
NumberOfOccurrences integer

重复事件的次数

提醒
Reminder integer

事件开始前几分钟的时间提醒

显示为
ShowAs string

事件期间要显示的状态

请求的响应
ResponseRequested boolean

如果发送方希望在接受或拒绝事件时收到响应,则设置为 true

返回

客户端的连接器特定日历事件模型类

创建联系人

此作在联系人文件夹中创建新的联系人。

参数

名称 密钥 必需 类型 说明
文件夹 ID
table True string

选择联系人文件夹

Id
Id string

联系人的唯一标识符。

父文件夹 ID
ParentFolderId string

联系人父文件夹的 ID

生日
Birthday date-time

联系人的生日

文件为
FileAs string

联系人在 下提交的姓名

显示名称
DisplayName string

联系人的显示名称

GivenName True string

联系人的给定名称

Initials
Initials string

联系人的缩写

中间名
MiddleName string

联系人的中间名称

昵称
NickName string

联系人的昵称

Surname
Surname string

联系人的姓氏

Title
Title string

联系人的标题

Generation
Generation string

联系人的生成

Name
Name string
地址
Address email
IM 地址
ImAddresses array of string

联系人的即时消息(IM)地址

职位名称
JobTitle string

联系人的职务

公司名称
CompanyName string

联系人公司的名称

Department
Department string

联系人部门

Office 位置
OfficeLocation string

联系人办公室的位置

职业
Profession string

联系人的职业

业务主页
BusinessHomePage string

联系人的业务主页

助理名称
AssistantName string

联系人助理的姓名

经理
Manager string

联系人经理的姓名

家庭电话
HomePhones True array of string

联系人的家庭电话号码

商务电话
BusinessPhones array of string

联系人的业务电话号码

移动电话
MobilePhone1 string

联系人的移动电话号码

街道
Street string
City
City string
State
State string
CountryOrRegion
CountryOrRegion string
邮政编码
PostalCode string
街道
Street string
City
City string
State
State string
CountryOrRegion
CountryOrRegion string
邮政编码
PostalCode string
街道
Street string
City
City string
State
State string
CountryOrRegion
CountryOrRegion string
邮政编码
PostalCode string
Yomi 公司名称
YomiCompanyName string

联系人的拼音日语公司名称

Yomi 给定名称
YomiGivenName string

联系人的拼音日语给定名称(名字)

Yomi 姓氏
YomiSurname string

联系人的拼音日语姓氏(姓氏)

类别
Categories array of string

与联系人关联的类别

更改密钥
ChangeKey string

标识事件对象的版本

创建时间
DateTimeCreated date-time

创建联系人的时间

上次修改时间
DateTimeLastModified date-time

修改联系人的时间

返回

联系人响应

删除事件

此作删除日历中的事件。

参数

名称 密钥 必需 类型 说明
日历 ID
table True string

选择日历

Id
id True string

选择事件

删除电子邮件

此作按 ID 删除电子邮件。

参数

名称 密钥 必需 类型 说明
消息 ID
messageId True string

要删除的电子邮件的 ID。

删除联系人

此作从联系人文件夹中删除联系人。

参数

名称 密钥 必需 类型 说明
文件夹 ID
table True string

选择联系人文件夹

Id
id True string

要删除的联系人的唯一标识符

发送批准电子邮件

此作发送审批电子邮件,并等待收件人的响应。 有关支持不同邮件客户端中的可作邮件,请参阅以下链接: https://docs.microsoft.com/outlook/actionable-messages/#outlook-version-requirements-for-actionable-messages

参数

名称 密钥 必需 类型 说明
To True email

指定用分号分隔的电子邮件地址,例如 someone@contoso.com

Subject
Subject string

Subject

用户选项
Options string

用户选项

标题文本
HeaderText string

电子邮件正文的标题文本

选择文本
SelectionText string

用户选项选择的标题文本

Body
Body string

Body

重要性
Importance string

重要性

Name
Name True string

附件名称

Content
ContentBytes True byte

附件内容

仅使用 HTML 消息
UseOnlyHTMLMessage boolean

仅使用 HTML 消息

隐藏 HTML 消息
HideHTMLMessage boolean

如果设置为“是”,则电子邮件正文处于隐藏状态,并且仅显示消息卡。 不支持可作邮件的电子邮件客户端将显示 HTML 消息,而不考虑参数值。

显示 HTML 确认对话框
ShowHTMLConfirmationDialog boolean

如果设置为“是”,则会显示一个对话框,以确认所选 HTML 邮件选项

返回

审批电子邮件响应

发送电子邮件 [已弃用]

此作已弃用。 请改用发送电子邮件(V2)。

此作会发送电子邮件。

参数

名称 密钥 必需 类型 说明
CC
Cc email

指定用分号分隔的电子邮件地址,例如 someone@contoso.com

BCC
Bcc email

指定用分号分隔的电子邮件地址,例如 someone@contoso.com

To True email

指定用分号分隔的电子邮件地址,例如 someone@contoso.com

Subject
Subject True string

指定邮件的主题

Body
Body True string

指定邮件正文

Name
Name True string

附件名称

Content
ContentBytes True byte

附件内容

回复
ReplyTo email

答复时要使用的电子邮件地址

重要性
Importance string

重要性

是 HTML
IsHtml boolean

Html 是吗?

发送电子邮件(V2)

此作会发送电子邮件。

参数

名称 密钥 必需 类型 说明
To True email

指定用分号分隔的电子邮件地址,例如 someone@contoso.com

Subject
Subject True string

指定邮件的主题

Body
Body True html

指定邮件正文

发件人 (发送为)
From email

要发送邮件的电子邮件地址(要求该邮箱具有“发送方式”或“代表发送”权限)。 有关授予权限的详细信息,请参阅 https://docs.microsoft.com/office365/admin/manage/send-email-as-distribution-list

CC
Cc email

指定用分号分隔的电子邮件地址,例如 someone@contoso.com

BCC
Bcc email

指定用分号分隔的电子邮件地址,例如 someone@contoso.com

Name
Name True string

附件名称

Content
ContentBytes True byte

附件内容

回复
ReplyTo email

答复时要使用的电子邮件地址

重要性
Importance string

重要性

响应事件邀请

响应事件邀请。

参数

名称 密钥 必需 类型 说明
事件 ID
event_id True string

要响应的事件的 ID。

响应
response True string

事件邀请的响应

注释
Comment string

注释

发送响应?
SendResponse boolean

向组织者发送响应?

回复电子邮件 [已弃用]

此作已弃用。 请改用答复电子邮件(V3)。

此作答复电子邮件。

参数

名称 密钥 必需 类型 说明
消息 ID
messageId True string

要答复的电子邮件的 ID。

注释
comment True string

回复批注。

全部答复
replyAll boolean

答复所有收件人。

更新事件 (V1) [已弃用]

此作已弃用。 请改用 更新事件(V3 )。

此作更新日历中的事件。 (V1)

参数

名称 密钥 必需 类型 说明
日历 ID
table True string

选择日历

Id
id True string

选择事件

Id
Id string

事件的唯一标识符

响应
Response string
Time
Time date-time
类型
Type string
Name
Name string
地址
Address email
内容类型
ContentType string
Content
Content string
正文预览
BodyPreview string

与事件关联的消息预览

类别
Categories array of string

与事件关联的类别

更改密钥
ChangeKey string

此属性标识事件对象的版本。 每次更改事件时,ChangeKey 也会更改。

创建时间
DateTimeCreated date-time

创建事件的日期和时间

上次修改时间
DateTimeLastModified date-time

上次修改事件的日期和时间

结束时间
End True date-time

事件的结束时间

结束时区
EndTimeZone string

此属性指定会议结束时间的时区。 该值必须在 Windows 中定义(例如:“太平洋标准时间”)。

是否有附件?
HasAttachments boolean

如果事件具有附件,则设置为 true

事件唯一 ID
ICalUId string

由不同日历中事件的所有实例共享的唯一标识符

重要性
Importance string

事件的重要性:低、正常或高

全天事件吗?
IsAllDay boolean

如果事件持续一整天,则设置为 true

是否已取消?
IsCancelled boolean

如果事件已取消,则设置为 true

是组织者
IsOrganizer boolean

如果邮件发件人也是组织者,则设置为 true

显示名称
DisplayName string
街道
Street string
City
City string
State
State string
CountryOrRegion
CountryOrRegion string
邮政编码
PostalCode string
Altitude
Altitude double
Latitude
Latitude double
Longitude
Longitude double
准确性
Accuracy double
AltitudeAccuracy
AltitudeAccuracy double
Name
Name string
地址
Address email
类型
Type string
时间间隔
Interval integer
月份
Month integer
DayOfMonth
DayOfMonth integer
DaysOfWeek
DaysOfWeek array of string
FirstDayOfWeek
FirstDayOfWeek string
Index
Index string
类型
Type string
开始日期
StartDate date-time
结束日期
EndDate date-time
NumberOfOccurrences
NumberOfOccurrences integer
提醒
Reminder integer

事件开始前几分钟的时间提醒

请求的响应
ResponseRequested boolean

如果发送方希望在接受或拒绝事件时收到响应,则设置为 true

响应
Response string
Time
Time date-time
系列主 ID
SeriesMasterId string

Series Master 事件类型的唯一标识符

显示为
ShowAs string

显示为忙或忙

开始时间
Start True date-time

事件的开始时间

开始时区
StartTimeZone string

此属性指定会议开始时间的时区。 该值必须在 Windows 中定义(例如:“太平洋标准时间”)。

Subject
Subject True string

事件主题

类型
Type string

事件类型:单个实例、事件、异常或系列主控形状

Web 链接
WebLink uri

与事件关联的消息预览

原因
Reason string

O365 同步事件协议使用的原因属性,如果是已删除的事件,将“删除”。

返回

后端的连接器特定的日历事件模型类

更新事件 (V2) [已弃用]

此作已弃用。 请改用 更新事件(V3 )。

此作更新日历中的事件。 (V2)

参数

名称 密钥 必需 类型 说明
日历 ID
table True string

选择日历

Id
id True string

选择事件

Subject
Subject True string

事件主题

开始时间
Start True date-time

事件的开始时间(例如:“2016-11-01T14:30:00Z”)

结束时间
End True date-time

事件的结束时间(例如:“2016-11-01T15:30:00Z”)

时区
TimeZone string

事件的时区

所需的与会者
RequiredAttendees email

活动所需的与会者,以分号分隔

可选与会者
OptionalAttendees email

活动(以分号分隔)的可选与会者

资源与会者
ResourceAttendees string

以分号分隔的事件的资源与会者

Body
Body string

与事件关联的消息正文

是 HTML
IsHtml boolean

如果正文为 Html,则设置为 true

位置
Location string

事件的位置

重要性
Importance string

事件的重要性:低、正常或高

全天事件吗?
IsAllDay boolean

如果事件持续一整天,则设置为 true

Recurrence
Recurrence string

事件的重复模式

定期结束时间
RecurrenceEnd date-time

重复周期的结束时间

出现次数
NumberOfOccurrences integer

重复事件的次数

提醒
Reminder integer

事件开始前几分钟的时间提醒

显示为
ShowAs string

事件期间要显示的状态

请求的响应
ResponseRequested boolean

如果发送方希望在接受或拒绝事件时收到响应,则设置为 true

返回

客户端的连接器特定日历事件模型类

更新事件 (V3)

此作更新日历中的事件。

参数

名称 密钥 必需 类型 说明
日历 ID
table True string

选择日历

Id
id True string

选择事件

Subject
Subject True string

事件主题

开始时间
Start True date-time

事件的开始时间(例如:“2016-11-01T14:30:00Z”)

结束时间
End True date-time

事件的结束时间(例如:“2016-11-01T15:30:00Z”)

时区
TimeZone string

事件的时区

所需的与会者
RequiredAttendees email

活动所需的与会者,以分号分隔

可选与会者
OptionalAttendees email

活动(以分号分隔)的可选与会者

资源与会者
ResourceAttendees string

以分号分隔的事件的资源与会者

Body
Body html

与事件关联的消息正文

位置
Location string

事件的位置

重要性
Importance string

事件的重要性:低、正常或高

全天事件吗?
IsAllDay boolean

如果事件持续一整天,则设置为 true

Recurrence
Recurrence string

事件的重复模式

定期结束时间
RecurrenceEnd date-time

重复周期的结束时间

出现次数
NumberOfOccurrences integer

重复事件的次数

提醒
Reminder integer

事件开始前几分钟的时间提醒

显示为
ShowAs string

事件期间要显示的状态

请求的响应
ResponseRequested boolean

如果发送方希望在接受或拒绝事件时收到响应,则设置为 true

返回

客户端的连接器特定日历事件模型类

更新联系人

此作更新联系人文件夹中的联系人。

参数

名称 密钥 必需 类型 说明
文件夹 ID
table True string

选择联系人文件夹

Id
id True string

要更新的联系人的唯一标识符

Id
Id string

联系人的唯一标识符。

父文件夹 ID
ParentFolderId string

联系人父文件夹的 ID

生日
Birthday date-time

联系人的生日

文件为
FileAs string

联系人在 下提交的姓名

显示名称
DisplayName string

联系人的显示名称

GivenName True string

联系人的给定名称

Initials
Initials string

联系人的缩写

中间名
MiddleName string

联系人的中间名称

昵称
NickName string

联系人的昵称

Surname
Surname string

联系人的姓氏

Title
Title string

联系人的标题

Generation
Generation string

联系人的生成

Name
Name string
地址
Address email
IM 地址
ImAddresses array of string

联系人的即时消息(IM)地址

职位名称
JobTitle string

联系人的职务

公司名称
CompanyName string

联系人公司的名称

Department
Department string

联系人部门

Office 位置
OfficeLocation string

联系人办公室的位置

职业
Profession string

联系人的职业

业务主页
BusinessHomePage string

联系人的业务主页

助理名称
AssistantName string

联系人助理的姓名

经理
Manager string

联系人经理的姓名

家庭电话
HomePhones True array of string

联系人的家庭电话号码

商务电话
BusinessPhones array of string

联系人的业务电话号码

移动电话
MobilePhone1 string

联系人的移动电话号码

街道
Street string
City
City string
State
State string
CountryOrRegion
CountryOrRegion string
邮政编码
PostalCode string
街道
Street string
City
City string
State
State string
CountryOrRegion
CountryOrRegion string
邮政编码
PostalCode string
街道
Street string
City
City string
State
State string
CountryOrRegion
CountryOrRegion string
邮政编码
PostalCode string
Yomi 公司名称
YomiCompanyName string

联系人的拼音日语公司名称

Yomi 给定名称
YomiGivenName string

联系人的拼音日语给定名称(名字)

Yomi 姓氏
YomiSurname string

联系人的拼音日语姓氏(姓氏)

类别
Categories array of string

与联系人关联的类别

更改密钥
ChangeKey string

标识事件对象的版本

创建时间
DateTimeCreated date-time

创建联系人的时间

上次修改时间
DateTimeLastModified date-time

修改联系人的时间

返回

联系人响应

标记为已读

此作将电子邮件标记为已阅读。

参数

名称 密钥 必需 类型 说明
消息 ID
messageId True string

要标记为已读的电子邮件的 ID。

标记电子邮件

此作标记电子邮件。

参数

名称 密钥 必需 类型 说明
消息 ID
messageId True string

要标记的电子邮件的 ID。

移动电子邮件

此作将电子邮件移动到指定文件夹。

参数

名称 密钥 必需 类型 说明
消息 ID
messageId True string

要移动的电子邮件的 ID。

文件夹
folderPath True string

要将电子邮件移动到的邮件文件夹。

返回

接收电子邮件

答复电子邮件 (V2) [已弃用]

此作已弃用。 请改用答复电子邮件(V3)。

此作答复电子邮件。

参数

名称 密钥 必需 类型 说明
消息 ID
messageId True string

要答复的电子邮件的 ID。

To email

示例: recipient1@domain.comrecipient2@domain.com

CC
Cc email

示例: recipient1@domain.comrecipient2@domain.com

BCC
Bcc email

示例: recipient1@domain.comrecipient2@domain.com

Subject
Subject string

电子邮件主题(如果为空,则使用原始主题)。

Body
Body string

电子邮件的内容。

全部答复
ReplyAll boolean

如果答复所有收件人,则为 True。 (默认值:False)

是 HTML
IsHtml boolean

如果以 HTML 形式发送答复,则为 True。 (默认值:True)

重要性
Importance string

选取重要性。 (默认值:低)

Name
Name True string

附件名称

Content
ContentBytes True byte

附件内容

答复电子邮件 (V3)

此作答复电子邮件。

参数

名称 密钥 必需 类型 说明
消息 ID
messageId True string

要答复的电子邮件的 ID。

To email

示例: recipient1@domain.comrecipient2@domain.com

CC
Cc email

示例: recipient1@domain.comrecipient2@domain.com

BCC
Bcc email

示例: recipient1@domain.comrecipient2@domain.com

Subject
Subject string

电子邮件主题(如果为空,则使用原始主题)。

Body
Body html

电子邮件的内容。

全部答复
ReplyAll boolean

如果答复所有收件人,则为 True。 (默认值:False)

重要性
Importance string

选取重要性。 (默认值:低)

Name
Name True string

附件名称

Content
ContentBytes True byte

附件内容

获取事件 (V1) [已弃用]

此作已弃用。 请改用 Get 事件 (V2)。

此作从日历中获取特定事件。 (V1)

参数

名称 密钥 必需 类型 说明
日历 ID
table True string

选择日历

项目 ID
id True string

选择事件

返回

后端的连接器特定的日历事件模型类

获取事件 (V1) [已弃用]

此作已弃用。 请改用 Get 事件(V3)。

此作从日历获取事件。 (V1)

参数

名称 密钥 必需 类型 说明
日历 ID
table True string

选择日历

订单依据
$orderby string

用于指定条目顺序的 ODATA orderBy 查询。

Top Count
$top integer

要检索的条目总数(默认值 = 全部)。

跳过计数
$skip integer

要跳过的条目数(默认值 = 0)。

返回

实体列表响应

获取事件 (V2)

此作从日历中获取特定事件。 (V2)

参数

名称 密钥 必需 类型 说明
日历 ID
table True string

选择日历

项目 ID
id True string

选择事件

返回

客户端的连接器特定日历事件模型类

获取事件 (V2) [已弃用]

此作已弃用。 请改用 Get 事件(V3)。

此作从日历获取事件。 (V2)

参数

名称 密钥 必需 类型 说明
日历 ID
table True string

选择日历

筛选查询
$filter string

ODATA 筛选器查询,用于限制返回的条目(例如 stringColumn eq 'string' OR numberColumn lt 123)。

订单依据
$orderby string

用于指定条目顺序的 ODATA orderBy 查询。

Top Count
$top integer

要检索的条目总数(默认值 = 全部)。

跳过计数
$skip integer

要跳过的条目数(默认值 = 0)。

返回

实体列表响应

获取事件 (V3)

此作从日历获取事件。 (V3)

参数

名称 密钥 必需 类型 说明
日历 ID
table True string

选择日历

筛选查询
$filter string

ODATA 筛选器查询,用于限制返回的条目(例如 stringColumn eq 'string' OR numberColumn lt 123)。

订单依据
$orderby string

用于指定条目顺序的 ODATA orderBy 查询。

Top Count
$top integer

要检索的条目总数(默认值 = 全部)。

跳过计数
$skip integer

要跳过的条目数(默认值 = 0)。

返回

日历项列表

获取事件的日历视图 [已弃用]

此作已弃用。 请改用 事件(V2)的日历视图

获取事件的日历视图。

参数

名称 密钥 必需 类型 说明
日历 ID
calendarId True string

选择日历。

开始时间
startDateTimeOffset True string

开始时间(例如:“2017-01-01T08:00:00-07:00”)。

结束时间
endDateTimeOffset True string

结束时间(例如:“2017-02-01T08:00:00-07:00”。

返回

包含列表和下一链接的响应

获取事件的日历视图 (V2)

此作获取日历中的所有事件(包括重复周期实例)。 (V2)

参数

名称 密钥 必需 类型 说明
日历 ID
calendarId True string

选择日历

开始时间
startDateTimeOffset True string

开始时间(例如:“2017-01-01T08:00:00-07:00”)

结束时间
endDateTimeOffset True string

结束时间(例如:“2017-02-01T08:00:00-07:00”)

筛选查询
$filter string

ODATA 筛选器查询,用于限制返回的条目(例如 stringColumn eq 'string' OR numberColumn lt 123)。

订单依据
$orderby string

用于指定条目顺序的 ODATA orderBy 查询。

Top Count
$top integer

要检索的条目总数(默认值 = 全部)。

跳过计数
$skip integer

要跳过的条目数(默认值 = 0)。

搜寻
search string

搜索文本以匹配事件正文和主题

返回

实体列表响应

获取日历

此作列出了可用的日历。

返回

实体列表响应

获取电子邮件

此作按 ID 获取电子邮件。

参数

名称 密钥 必需 类型 说明
消息 ID
messageId True string

电子邮件的 ID。

包括附件
includeAttachments boolean

如果设置为 true,附件内容也会随电子邮件一起检索。

Internet 消息 ID
internetMessageId string

Internet 消息 ID。

返回

接收电子邮件

获取电子邮件 [已弃用]

此作已弃用。 请改用“获取电子邮件”(V2)。

此作从文件夹获取电子邮件。

参数

名称 密钥 必需 类型 说明
文件夹
folderPath string

要从中检索电子邮件的邮件文件夹(默认值:“收件箱”)。

仅提取未读消息
fetchOnlyUnread boolean

仅检索未读的电子邮件?。

包括附件
includeAttachments boolean

如果设置为 true,附件内容也会随电子邮件一起检索。

搜索查询
searchQuery string

搜索查询(如在 Outlook 客户端中)筛选电子邮件。

Top
top integer

要检索的电子邮件数(默认值:10)。

返回

获取电子邮件 (V2)

此作从文件夹获取电子邮件。

参数

名称 密钥 必需 类型 说明
文件夹
folderPath string

要从中检索电子邮件的邮件文件夹(默认值:“收件箱”)。

to email

以分号分隔的收件人电子邮件地址(如果有匹配项,触发器将运行)。

CC
cc email

抄送收件人电子邮件地址用分号分隔(如果有匹配项,触发器将运行)。

收件人或抄送
toOrCc email

收件人或抄送收件人电子邮件地址(如果有任何匹配项,触发器将运行)。

来自
from email

发件人电子邮件地址用分号分隔(如果有匹配项,触发器将运行)。

重要性
importance string

电子邮件的重要性(任何、高、正常、低)。

仅包含附件
fetchOnlyWithAttachment boolean

如果设置为 true,将只检索包含附件的电子邮件。 将跳过不包含任何附件的电子邮件。 如果设置为 false,将检索所有电子邮件。

主题筛选器
subjectFilter string

在主题行中查找的字符串。

仅提取未读消息
fetchOnlyUnread boolean

仅检索未读的电子邮件?。

包括附件
includeAttachments boolean

如果设置为 true,附件内容也会随电子邮件一起检索。

搜索查询
searchQuery string

搜索查询以筛选电子邮件。 如何使用“$search”参数,请参阅: https://docs.microsoft.com/previous-versions/office/office-365-api/api/version-2.0/complex-types-for-mail-contacts-calendar#search-requests

Top
top integer

要检索的电子邮件数(默认值:10)。

返回

表示批处理响应的包装对象

获取联系人

此作从联系人文件夹中获取特定联系人。

参数

名称 密钥 必需 类型 说明
文件夹 ID
table True string

选择联系人文件夹

项目 ID
id True string

要检索的联系人的唯一标识符

返回

联系人响应

获取联系人

此作从联系人文件夹中获取联系人。

参数

名称 密钥 必需 类型 说明
文件夹 ID
table True string

要检索的联系人文件夹的唯一标识符

筛选查询
$filter string

ODATA 筛选器查询,用于限制返回的条目(例如 stringColumn eq 'string' OR numberColumn lt 123)。

订单依据
$orderby string

用于指定条目顺序的 ODATA orderBy 查询。

Top Count
$top integer

要检索的条目总数(默认值 = 全部)。

跳过计数
$skip integer

要跳过的条目数(默认值 = 0)。

返回

实体列表响应

获取联系人文件夹

此作列出了可用的联系人文件夹。

返回

实体列表响应

获取附件

此作按 ID 获取电子邮件附件。

参数

名称 密钥 必需 类型 说明
消息 ID
messageId True string

电子邮件的 ID。

附件 ID
attachmentId True string

要下载的附件的 ID。

返回

response
binary

转发电子邮件

转发电子邮件。

参数

名称 密钥 必需 类型 说明
消息 ID
message_id True string

要转发的消息的 ID。

注释
Comment string

注释

ToRecipients True string

要将邮件转发到的收件人的分号分隔列表

触发器

修改事件时 (V1) [已弃用]

此作已弃用。 请改用修改事件时(V2)。

此作在日历中修改事件时触发流。 (V1)

修改事件时 (V2)

此作在日历中修改事件时触发流。 (V2)

创建新事件时 (V1) [已弃用]

此作已弃用。 请改用创建新事件时(V2)。

此作在日历中创建新事件时触发流。 (V1)

创建新事件时(V2)

此作在日历中创建新事件时触发流。 (V2)

即将启动的事件时[已弃用]

此作已弃用。 请改用即将开始的事件(V2)。

当即将启动的日历事件时,此作将触发流。

即将开始的事件时(V2)

当即将启动的日历事件时,此作将触发流。

当一封提及我的新电子邮件到达时 (V2)

此作在提及我的新电子邮件到达时触发流。 它将跳过任何总邮件大小大于 Exchange 管理员所施加的限制或 50 MB 的电子邮件,以小于任何大小。 它还可能跳过具有无效正文或附件的受保护电子邮件和电子邮件。

当提及我的新电子邮件到达时 [已弃用]

此作已弃用。 请改用提及我的新电子邮件(V2)。

此作在提及我的新电子邮件到达时触发流。 它将跳过任何总邮件大小大于 Exchange 管理员所施加的限制或 50 MB 的电子邮件,以小于任何大小。 它还可能跳过具有无效正文或附件的受保护电子邮件和电子邮件。

新电子邮件到达时 [已弃用]

此作已弃用。 请改用新电子邮件到达时(V2)。

当新电子邮件到达时,此作会触发流。 它将跳过任何总邮件大小大于 Exchange 管理员所施加的限制或 50 MB 的电子邮件,以小于任何大小。 它还可能跳过具有无效正文或附件的受保护电子邮件和电子邮件。

新电子邮件到达时(V2)

当新电子邮件到达时,此作会触发流。 它将跳过任何总邮件大小大于 Exchange 管理员所施加的限制或 50 MB 的电子邮件,以小于任何大小。 它还可能跳过具有无效正文或附件的受保护电子邮件和电子邮件。

标记电子邮件时 [已弃用]

此作已弃用。 请改用电子邮件标记时(V2)。

此作在标记电子邮件时触发流。

标记电子邮件时(V2)

此作在标记电子邮件时触发流。

添加、更新或删除事件时 [已弃用]

此作已弃用。 请改用添加、更新或删除事件(V2)。

此作在日历中添加、更新或删除事件时触发流。

添加、更新或删除事件时(V2)

此作在日历中添加、更新或删除事件时触发流。

修改事件时 (V1) [已弃用]

此作已弃用。 请改用修改事件时(V2)。

此作在日历中修改事件时触发流。 (V1)

参数

名称 密钥 必需 类型 说明
日历 ID
table True string

选择日历

订单依据
$orderby string

用于指定条目顺序的 ODATA orderBy 查询。

Top Count
$top integer

要检索的条目总数(默认值 = 全部)。

跳过计数
$skip integer

要跳过的条目数(默认值 = 0)。

返回

日历项列表

修改事件时 (V2)

此作在日历中修改事件时触发流。 (V2)

参数

名称 密钥 必需 类型 说明
日历 ID
table True string

选择日历

订单依据
$orderby string

用于指定条目顺序的 ODATA orderBy 查询。

Top Count
$top integer

要检索的条目总数(默认值 = 全部)。

跳过计数
$skip integer

要跳过的条目数(默认值 = 0)。

返回

日历项列表

创建新事件时 (V1) [已弃用]

此作已弃用。 请改用创建新事件时(V2)。

此作在日历中创建新事件时触发流。 (V1)

参数

名称 密钥 必需 类型 说明
日历 ID
table True string

选择日历

订单依据
$orderby string

用于指定条目顺序的 ODATA orderBy 查询。

Top Count
$top integer

要检索的条目总数(默认值 = 全部)。

跳过计数
$skip integer

要跳过的条目数(默认值 = 0)。

返回

日历项列表

创建新事件时(V2)

此作在日历中创建新事件时触发流。 (V2)

参数

名称 密钥 必需 类型 说明
日历 ID
table True string

选择日历

订单依据
$orderby string

用于指定条目顺序的 ODATA orderBy 查询。

Top Count
$top integer

要检索的条目总数(默认值 = 全部)。

跳过计数
$skip integer

要跳过的条目数(默认值 = 0)。

返回

日历项列表

即将启动的事件时[已弃用]

此作已弃用。 请改用即将开始的事件(V2)。

当即将启动的日历事件时,此作将触发流。

参数

名称 密钥 必需 类型 说明
日历 ID
table True string

日历的唯一标识符。

Look-Ahead 时间
lookAheadTimeInMinutes integer

查找即将发生的事件的时间(以分钟为单位)。

返回

日历项列表

即将开始的事件时(V2)

当即将启动的日历事件时,此作将触发流。

参数

名称 密钥 必需 类型 说明
日历 ID
table True string

日历的唯一标识符。

Look-Ahead 时间
lookAheadTimeInMinutes integer

查找即将发生的事件的时间(以分钟为单位)。

返回

日历项列表

当一封提及我的新电子邮件到达时 (V2)

此作在提及我的新电子邮件到达时触发流。 它将跳过任何总邮件大小大于 Exchange 管理员所施加的限制或 50 MB 的电子邮件,以小于任何大小。 它还可能跳过具有无效正文或附件的受保护电子邮件和电子邮件。

参数

名称 密钥 必需 类型 说明
文件夹
folderPath string

要检查新电子邮件的邮件文件夹。

to email

以分号分隔的收件人电子邮件地址(如果有匹配项,触发器将运行)。

CC
cc email

抄送收件人电子邮件地址用分号分隔(如果有匹配项,触发器将运行)。

收件人或抄送
toOrCc email

收件人或抄送收件人电子邮件地址(如果有任何匹配项,触发器将运行)。

来自
from email

发件人电子邮件地址用分号分隔(如果有匹配项,触发器将运行)。

重要性
importance string

电子邮件的重要性(任何、高、正常、低)。

仅包含附件
fetchOnlyWithAttachment boolean

如果设置为 true,将只检索包含附件的电子邮件。 将跳过不包含任何附件的电子邮件。 如果设置为 false,将检索所有电子邮件。

包括附件
includeAttachments boolean

触发器的响应是否包括附件内容。

主题筛选器
subjectFilter string

在主题行中查找的字符串。

返回

表示批处理触发器响应的包装对象

当提及我的新电子邮件到达时 [已弃用]

此作已弃用。 请改用提及我的新电子邮件(V2)。

此作在提及我的新电子邮件到达时触发流。 它将跳过任何总邮件大小大于 Exchange 管理员所施加的限制或 50 MB 的电子邮件,以小于任何大小。 它还可能跳过具有无效正文或附件的受保护电子邮件和电子邮件。

参数

名称 密钥 必需 类型 说明
文件夹
folderPath string

要检查新电子邮件的邮件文件夹。

to email

以分号分隔的收件人电子邮件地址(如果有匹配项,触发器将运行)。

CC
cc email

抄送收件人电子邮件地址用分号分隔(如果有匹配项,触发器将运行)。

收件人或抄送
toOrCc email

收件人或抄送收件人电子邮件地址(如果有任何匹配项,触发器将运行)。

来自
from email

发件人电子邮件地址用分号分隔(如果有匹配项,触发器将运行)。

重要性
importance string

电子邮件的重要性(任何、高、正常、低)。

仅包含附件
fetchOnlyWithAttachment boolean

如果设置为 true,将只检索包含附件的电子邮件。 将跳过不包含任何附件的电子邮件。 如果设置为 false,将检索所有电子邮件。

包括附件
includeAttachments boolean

触发器的响应是否包括附件内容。

主题筛选器
subjectFilter string

在主题行中查找的字符串。

返回

表示批处理触发器响应的包装对象

新电子邮件到达时 [已弃用]

此作已弃用。 请改用新电子邮件到达时(V2)。

当新电子邮件到达时,此作会触发流。 它将跳过任何总邮件大小大于 Exchange 管理员所施加的限制或 50 MB 的电子邮件,以小于任何大小。 它还可能跳过具有无效正文或附件的受保护电子邮件和电子邮件。

参数

名称 密钥 必需 类型 说明
文件夹
folderPath string

要检查新电子邮件的邮件文件夹。

to email

以分号分隔的收件人电子邮件地址(如果有匹配项,触发器将运行)。

CC
cc email

抄送收件人电子邮件地址用分号分隔(如果有匹配项,触发器将运行)。

收件人或抄送
toOrCc email

收件人或抄送收件人电子邮件地址(如果有任何匹配项,触发器将运行)。

来自
from email

发件人电子邮件地址用分号分隔(如果有匹配项,触发器将运行)。

重要性
importance string

电子邮件的重要性(任何、高、正常、低)。

仅包含附件
fetchOnlyWithAttachment boolean

如果设置为 true,将只检索包含附件的电子邮件。 将跳过不包含任何附件的电子邮件。 如果设置为 false,将检索所有电子邮件。

包括附件
includeAttachments boolean

触发器的响应是否包括附件内容。

主题筛选器
subjectFilter string

在主题行中查找的字符串。

返回

表示批处理触发器响应的包装对象

新电子邮件到达时(V2)

当新电子邮件到达时,此作会触发流。 它将跳过任何总邮件大小大于 Exchange 管理员所施加的限制或 50 MB 的电子邮件,以小于任何大小。 它还可能跳过具有无效正文或附件的受保护电子邮件和电子邮件。

参数

名称 密钥 必需 类型 说明
文件夹
folderPath string

要检查新电子邮件的邮件文件夹。

to email

以分号分隔的收件人电子邮件地址(如果有匹配项,触发器将运行)。

CC
cc email

抄送收件人电子邮件地址用分号分隔(如果有匹配项,触发器将运行)。

收件人或抄送
toOrCc email

收件人或抄送收件人电子邮件地址(如果有任何匹配项,触发器将运行)。

来自
from email

发件人电子邮件地址用分号分隔(如果有匹配项,触发器将运行)。

重要性
importance string

电子邮件的重要性(任何、高、正常、低)。

仅包含附件
fetchOnlyWithAttachment boolean

如果设置为 true,将只检索包含附件的电子邮件。 将跳过不包含任何附件的电子邮件。 如果设置为 false,将检索所有电子邮件。

包括附件
includeAttachments boolean

触发器的响应是否包括附件内容。

主题筛选器
subjectFilter string

在主题行中查找的字符串。

返回

表示批处理触发器响应的包装对象

标记电子邮件时 [已弃用]

此作已弃用。 请改用电子邮件标记时(V2)。

此作在标记电子邮件时触发流。

参数

名称 密钥 必需 类型 说明
文件夹
folderPath string

要检查新电子邮件的邮件文件夹。

to email

以分号分隔的收件人电子邮件地址(如果有匹配项,触发器将运行)。

CC
cc email

抄送收件人电子邮件地址用分号分隔(如果有匹配项,触发器将运行)。

收件人或抄送
toOrCc email

收件人或抄送收件人电子邮件地址(如果有任何匹配项,触发器将运行)。

来自
from email

发件人电子邮件地址用分号分隔(如果有匹配项,触发器将运行)。

重要性
importance string

电子邮件的重要性(任何、高、正常、低)。

仅包含附件
fetchOnlyWithAttachment boolean

如果设置为 true,将只检索包含附件的电子邮件。 将跳过不包含任何附件的电子邮件。 如果设置为 false,将检索所有电子邮件。

包括附件
includeAttachments boolean

触发器的响应是否包括附件内容。

主题筛选器
subjectFilter string

在主题行中查找的字符串。

返回

表示批处理触发器响应的包装对象

标记电子邮件时(V2)

此作在标记电子邮件时触发流。

参数

名称 密钥 必需 类型 说明
文件夹
folderPath string

要检查新电子邮件的邮件文件夹。

to email

以分号分隔的收件人电子邮件地址(如果有匹配项,触发器将运行)。

CC
cc email

抄送收件人电子邮件地址用分号分隔(如果有匹配项,触发器将运行)。

收件人或抄送
toOrCc email

收件人或抄送收件人电子邮件地址(如果有任何匹配项,触发器将运行)。

来自
from email

发件人电子邮件地址用分号分隔(如果有匹配项,触发器将运行)。

重要性
importance string

电子邮件的重要性(任何、高、正常、低)。

仅包含附件
fetchOnlyWithAttachment boolean

如果设置为 true,将只检索包含附件的电子邮件。 将跳过不包含任何附件的电子邮件。 如果设置为 false,将检索所有电子邮件。

包括附件
includeAttachments boolean

触发器的响应是否包括附件内容。

主题筛选器
subjectFilter string

在主题行中查找的字符串。

返回

表示批处理触发器响应的包装对象

添加、更新或删除事件时 [已弃用]

此作已弃用。 请改用添加、更新或删除事件(V2)。

此作在日历中添加、更新或删除事件时触发流。

参数

名称 密钥 必需 类型 说明
日历 ID
table True string

选择日历

跟踪的传入天数
incomingDays integer

要跟踪的日历中的传入天数

过去几天已跟踪
pastDays integer

要跟踪的日历中的过去天数

返回

具有作类型的日历项列表

添加、更新或删除事件时(V2)

此作在日历中添加、更新或删除事件时触发流。

参数

名称 密钥 必需 类型 说明
日历 ID
table True string

选择日历

跟踪的传入天数
incomingDays integer

要跟踪的日历中的传入天数

过去几天已跟踪
pastDays integer

要跟踪的日历中的过去天数

返回

具有作类型的日历项列表

定义

CalendarEventList

日历项列表

名称 路径 类型 说明
value
value array of CalendarEventBackend

日历项列表

CalendarEventBackend

后端的连接器特定的日历事件模型类

名称 路径 类型 说明
Id
Id string

事件的唯一标识符

与会者
Attendees array of Attendee

活动的与会者列表

Body
Body ItemBody
正文预览
BodyPreview string

与事件关联的消息预览

类别
Categories array of string

与事件关联的类别

更改密钥
ChangeKey string

此属性标识事件对象的版本。 每次更改事件时,ChangeKey 也会更改。

创建时间
DateTimeCreated date-time

创建事件的日期和时间

上次修改时间
DateTimeLastModified date-time

上次修改事件的日期和时间

结束时间
End date-time

事件的结束时间

结束时区
EndTimeZone string

此属性指定会议结束时间的时区。 该值必须在 Windows 中定义(例如:“太平洋标准时间”)。

是否有附件?
HasAttachments boolean

如果事件具有附件,则设置为 true

事件唯一 ID
ICalUId string

由不同日历中事件的所有实例共享的唯一标识符

重要性
Importance string

事件的重要性:低、正常或高

全天事件吗?
IsAllDay boolean

如果事件持续一整天,则设置为 true

是否已取消?
IsCancelled boolean

如果事件已取消,则设置为 true

是组织者
IsOrganizer boolean

如果邮件发件人也是组织者,则设置为 true

位置
Location Location
组织者
Organizer Recipient
Recurrence
Recurrence PatternedRecurrence
提醒
Reminder integer

事件开始前几分钟的时间提醒

请求的响应
ResponseRequested boolean

如果发送方希望在接受或拒绝事件时收到响应,则设置为 true

ResponseStatus
ResponseStatus ResponseStatus
系列主 ID
SeriesMasterId string

Series Master 事件类型的唯一标识符

显示为
ShowAs string

显示为忙或忙

开始时间
Start date-time

事件的开始时间

开始时区
StartTimeZone string

此属性指定会议开始时间的时区。 该值必须在 Windows 中定义(例如:“太平洋标准时间”)。

Subject
Subject string

事件主题

类型
Type string

事件类型:单个实例、事件、异常或系列主控形状

Web 链接
WebLink uri

与事件关联的消息预览

原因
Reason string

O365 同步事件协议使用的原因属性,如果是已删除的事件,将“删除”。

与会者

名称 路径 类型 说明
状态
Status ResponseStatus
类型
Type string
电子邮件地址
EmailAddress EmailAddress

ItemBody

名称 路径 类型 说明
内容类型
ContentType string
Content
Content string

位置

名称 路径 类型 说明
显示名称
DisplayName string
地址
Address PhysicalAddress
坐标
Coordinates GeoCoordinates

Recipient

名称 路径 类型 说明
电子邮件地址
EmailAddress EmailAddress

PatternedRecurrence

名称 路径 类型 说明
图案
Pattern RecurrencePattern
范围
Range RecurrenceRange

ResponseStatus

名称 路径 类型 说明
响应
Response string
Time
Time date-time

电子邮件地址

名称 路径 类型 说明
Name
Name string
地址
Address email

PhysicalAddress

名称 路径 类型 说明
街道
Street string
City
City string
State
State string
CountryOrRegion
CountryOrRegion string
邮政编码
PostalCode string

GeoCoordinates

名称 路径 类型 说明
Altitude
Altitude double
Latitude
Latitude double
Longitude
Longitude double
准确性
Accuracy double
AltitudeAccuracy
AltitudeAccuracy double

RecurrencePattern

名称 路径 类型 说明
类型
Type string
时间间隔
Interval integer
月份
Month integer
DayOfMonth
DayOfMonth integer
DaysOfWeek
DaysOfWeek array of string
FirstDayOfWeek
FirstDayOfWeek string
Index
Index string

RecurrenceRange

名称 路径 类型 说明
类型
Type string
开始日期
StartDate date-time
结束日期
EndDate date-time
NumberOfOccurrences
NumberOfOccurrences integer

CalendarEventListClientReceive

日历项列表

名称 路径 类型 说明
value
value array of CalendarEventClientReceive

日历项列表

CalendarEventClientReceive

客户端的连接器特定日历事件模型类

名称 路径 类型 说明
Subject
Subject string

事件主题

开始时间
Start date-time

事件的开始时间(例如:“2016-11-01T14:30:00Z”)

结束时间
End date-time

事件的结束时间(例如:“2016-11-01T15:30:00Z”)

显示为
ShowAs integer

活动期间要显示的状态(未知 - -1、免费 - 0、暂定 - 1、忙碌 - 2、Oof - 3、WorkingElsewhere - 4)

Recurrence
Recurrence integer

事件的重复模式(无 - 0、每日 - 1、每周 - 2、每月 - 3、每年 - 4)

响应类型
ResponseType integer

事件的响应类型 (None - 0, Organizer - 1, TentativelyAccepted - 2, Accepted - 3, Declined - 4, NotResponded - 5)

答复时间
ResponseTime date-time

事件的响应时间

事件唯一 ID
ICalUId string

由不同日历中事件的所有实例共享的唯一标识符

重要性
Importance integer

事件的重要性(0 - 低,1 - 正常,2 - 高)

Id
Id string

事件的唯一标识符

创建时间
DateTimeCreated date-time

创建事件的日期和时间

上次修改时间
DateTimeLastModified date-time

上次修改事件的日期和时间

组织者
Organizer email

活动的组织者

时区
TimeZone string

事件的时区

系列主 ID
SeriesMasterId string

Series Master 事件类型的唯一标识符

类别
Categories array of string

与事件关联的类别

Web 链接
WebLink uri

在 Outlook Web App 中打开事件的 URL

所需的与会者
RequiredAttendees email

活动所需的与会者,以分号分隔

可选与会者
OptionalAttendees email

活动(以分号分隔)的可选与会者

资源与会者
ResourceAttendees string

以分号分隔的事件的资源与会者

Body
Body string

与事件关联的消息正文

是 HTML
IsHtml boolean

如果正文为 Html,则设置为 true

位置
Location string

事件的位置

全天事件吗?
IsAllDay boolean

如果事件持续一整天,则设置为 true

定期结束时间
RecurrenceEnd date-time

重复周期的结束时间

出现次数
NumberOfOccurrences integer

重复事件的次数

提醒
Reminder integer

事件开始前几分钟的时间提醒

请求的响应
ResponseRequested boolean

如果发送方希望在接受或拒绝事件时收到响应,则设置为 true

PaginatedListResponse[CalendarEventClientReceiveStringEnums]

包含列表和下一链接的响应

名称 路径 类型 说明
价值观
Values array of CalendarEventClientReceiveStringEnums

价值观

CalendarEventClientReceiveStringEnums

客户端的连接器特定日历事件模型类

名称 路径 类型 说明
重要性
Importance string

事件的重要性:低、正常或高

响应类型
ResponseType string

事件的响应类型:None、Organizer、TentativelyAccepted、Accepted、Declined 或 NotResponded

Recurrence
Recurrence string

事件的重复模式

显示为
ShowAs string

事件期间要显示的状态

Subject
Subject string

事件主题

开始时间
Start date-time

事件的开始时间(例如:“2016-11-01T14:30:00Z”)

结束时间
End date-time

事件的结束时间(例如:“2016-11-01T15:30:00Z”)

答复时间
ResponseTime date-time

事件的响应时间

事件唯一 ID
ICalUId string

由不同日历中事件的所有实例共享的唯一标识符

Id
Id string

事件的唯一标识符

创建时间
DateTimeCreated date-time

创建事件的日期和时间

上次修改时间
DateTimeLastModified date-time

上次修改事件的日期和时间

组织者
Organizer email

活动的组织者

时区
TimeZone string

事件的时区

系列主 ID
SeriesMasterId string

Series Master 事件类型的唯一标识符

类别
Categories array of string

与事件关联的类别

Web 链接
WebLink uri

在 Outlook Web App 中打开事件的 URL

所需的与会者
RequiredAttendees email

活动所需的与会者,以分号分隔

可选与会者
OptionalAttendees email

活动(以分号分隔)的可选与会者

资源与会者
ResourceAttendees string

以分号分隔的事件的资源与会者

Body
Body string

与事件关联的消息正文

是 HTML
IsHtml boolean

如果正文为 Html,则设置为 true

位置
Location string

事件的位置

全天事件吗?
IsAllDay boolean

如果事件持续一整天,则设置为 true

定期结束时间
RecurrenceEnd date-time

重复周期的结束时间

出现次数
NumberOfOccurrences integer

重复事件的次数

提醒
Reminder integer

事件开始前几分钟的时间提醒

请求的响应
ResponseRequested boolean

如果发送方希望在接受或拒绝事件时收到响应,则设置为 true

ClientReceiveMessageStringEnums

接收电子邮件

名称 路径 类型 说明
重要性
Importance string

消息的重要性

来自
From email

邮件的邮箱所有者和发件人

To email

邮件的收件人

CC
Cc email

邮件的抄送收件人

BCC
Bcc email

邮件的密件抄送收件人

回复
ReplyTo email

答复时要使用的电子邮件地址

Subject
Subject string

邮件的主题

Body
Body string

消息正文

正文预览
BodyPreview string

消息预览

具有附件
HasAttachment boolean

指示邮件是否具有附件

消息 ID
Id string

消息的唯一标识符

Internet 消息 ID
InternetMessageId string

RFC2822指定的格式的消息 ID

对话 ID
ConversationId string

电子邮件所属对话的 ID

接收时间
DateTimeReceived date-time

接收消息的日期和时间

已读
IsRead boolean

指示是否已读取消息

附件
Attachments array of ClientReceiveFileAttachment

邮件的文件附件

是 HTML
IsHtml boolean

Html 是吗?

ClientReceiveFileAttachment

文件附件

名称 路径 类型 说明
附件 ID
Id string

附件 ID

Name
Name string

附件名称

Content
ContentBytes byte

附件内容

Content-Type
ContentType string

附件内容类型

尺寸
Size integer

附件的大小(以字节为单位)

内联
IsInline boolean

如果这是内联附件,则设置为 true

上次修改的 DateTime
LastModifiedDateTime date-time

上次修改附件的日期和时间

内容 ID
ContentId string

内容 ID

BatchResponse[ClientReceiveMessage]

表示批处理响应的包装对象

名称 路径 类型 说明
value
value array of ClientReceiveMessage

响应对象的列表

ClientReceiveMessage

接收电子邮件

名称 路径 类型 说明
来自
From email

邮件的邮箱所有者和发件人

To email

邮件的收件人

CC
Cc email

邮件的抄送收件人

BCC
Bcc email

邮件的密件抄送收件人

回复
ReplyTo email

答复时要使用的电子邮件地址

Subject
Subject string

邮件的主题

Body
Body string

消息正文

重要性
Importance integer

邮件的重要性(0 - 低,1 - 正常,2 - 高)

正文预览
BodyPreview string

消息预览

具有附件
HasAttachment boolean

指示邮件是否具有附件

消息 ID
Id string

消息的唯一标识符

Internet 消息 ID
InternetMessageId string

RFC2822指定的格式的消息 ID

对话 ID
ConversationId string

电子邮件所属对话的 ID

接收时间
DateTimeReceived date-time

接收消息的日期和时间

已读
IsRead boolean

指示是否已读取消息

附件
Attachments array of ClientReceiveFileAttachment

邮件的文件附件

是 HTML
IsHtml boolean

Html 是吗?

TriggerBatchResponse[ClientReceiveMessage]

表示批处理触发器响应的包装对象

名称 路径 类型 说明
value
value array of ClientReceiveMessage

响应对象的列表

ApprovalEmailResponse

审批电子邮件响应

名称 路径 类型 说明
SelectedOption
SelectedOption string

用户响应

EntityListResponse[表]

实体列表响应

名称 路径 类型 说明
value
value array of Table

值列表

Table

表示表。

名称 路径 类型 说明
Name
Name string

表的名称。 名称在运行时使用。

显示名称
DisplayName string

表的显示名称。

DynamicProperties
DynamicProperties object

连接器提供给客户端的其他表属性。

EntityListResponse[CalendarEventBackend]

实体列表响应

名称 路径 类型 说明
value
value array of CalendarEventBackend

值列表

EntityListResponse[CalendarEventClientReceiveStringEnums]

实体列表响应

名称 路径 类型 说明
value
value array of CalendarEventClientReceiveStringEnums

值列表

CalendarEventListWithActionType

具有作类型的日历项列表

名称 路径 类型 说明
value
value array of CalendarEventClientWithActionType

日历项列表

CalendarEventClientWithActionType

具有作类型的日历事件模型

名称 路径 类型 说明
操作类型
ActionType string

已更改事件的作类型 - 已添加、更新或删除。

已添加
IsAdded boolean

指示自上次轮询触发器以来是否添加了事件的标志。

已更新
IsUpdated boolean

指示自触发器上次轮询以来事件是否已更新的标志。

Subject
Subject string

事件主题

开始时间
Start date-time

事件的开始时间(例如:“2016-11-01T14:30:00Z”)

结束时间
End date-time

事件的结束时间(例如:“2016-11-01T15:30:00Z”)

显示为
ShowAs integer

活动期间要显示的状态(未知 - -1、免费 - 0、暂定 - 1、忙碌 - 2、Oof - 3、WorkingElsewhere - 4)

Recurrence
Recurrence integer

事件的重复模式(无 - 0、每日 - 1、每周 - 2、每月 - 3、每年 - 4)

响应类型
ResponseType integer

事件的响应类型 (None - 0, Organizer - 1, TentativelyAccepted - 2, Accepted - 3, Declined - 4, NotResponded - 5)

答复时间
ResponseTime date-time

事件的响应时间

事件唯一 ID
ICalUId string

由不同日历中事件的所有实例共享的唯一标识符

重要性
Importance integer

事件的重要性(0 - 低,1 - 正常,2 - 高)

Id
Id string

事件的唯一标识符

创建时间
DateTimeCreated date-time

创建事件的日期和时间

上次修改时间
DateTimeLastModified date-time

上次修改事件的日期和时间

组织者
Organizer email

活动的组织者

时区
TimeZone string

事件的时区

系列主 ID
SeriesMasterId string

Series Master 事件类型的唯一标识符

类别
Categories array of string

与事件关联的类别

Web 链接
WebLink uri

在 Outlook Web App 中打开事件的 URL

所需的与会者
RequiredAttendees email

活动所需的与会者,以分号分隔

可选与会者
OptionalAttendees email

活动(以分号分隔)的可选与会者

资源与会者
ResourceAttendees string

以分号分隔的事件的资源与会者

Body
Body string

与事件关联的消息正文

是 HTML
IsHtml boolean

如果正文为 Html,则设置为 true

位置
Location string

事件的位置

全天事件吗?
IsAllDay boolean

如果事件持续一整天,则设置为 true

定期结束时间
RecurrenceEnd date-time

重复周期的结束时间

出现次数
NumberOfOccurrences integer

重复事件的次数

提醒
Reminder integer

事件开始前几分钟的时间提醒

请求的响应
ResponseRequested boolean

如果发送方希望在接受或拒绝事件时收到响应,则设置为 true

EntityListResponse[ContactResponse]

实体列表响应

名称 路径 类型 说明
value
value array of ContactResponse

值列表

ContactResponse

联系人响应

名称 路径 类型 说明
GivenName string

联系人的给定名称

家庭电话
HomePhones array of string

联系人的家庭电话号码

Id
Id string

联系人的唯一标识符。

父文件夹 ID
ParentFolderId string

联系人父文件夹的 ID

生日
Birthday date-time

联系人的生日

文件为
FileAs string

联系人在 下提交的姓名

显示名称
DisplayName string

联系人的显示名称

Initials
Initials string

联系人的缩写

中间名
MiddleName string

联系人的中间名称

昵称
NickName string

联系人的昵称

Surname
Surname string

联系人的姓氏

Title
Title string

联系人的标题

Generation
Generation string

联系人的生成

电子邮件地址
EmailAddresses array of EmailAddress

联系人的电子邮件地址

IM 地址
ImAddresses array of string

联系人的即时消息(IM)地址

职位名称
JobTitle string

联系人的职务

公司名称
CompanyName string

联系人公司的名称

Department
Department string

联系人部门

Office 位置
OfficeLocation string

联系人办公室的位置

职业
Profession string

联系人的职业

业务主页
BusinessHomePage string

联系人的业务主页

助理名称
AssistantName string

联系人助理的姓名

经理
Manager string

联系人经理的姓名

商务电话
BusinessPhones array of string

联系人的业务电话号码

移动电话
MobilePhone1 string

联系人的移动电话号码

HomeAddress
HomeAddress PhysicalAddress
BusinessAddress
BusinessAddress PhysicalAddress
OtherAddress
OtherAddress PhysicalAddress
Yomi 公司名称
YomiCompanyName string

联系人的拼音日语公司名称

Yomi 给定名称
YomiGivenName string

联系人的拼音日语给定名称(名字)

Yomi 姓氏
YomiSurname string

联系人的拼音日语姓氏(姓氏)

类别
Categories array of string

与联系人关联的类别

更改密钥
ChangeKey string

标识事件对象的版本

创建时间
DateTimeCreated date-time

创建联系人的时间

上次修改时间
DateTimeLastModified date-time

修改联系人的时间

二进制

这是基本数据类型“binary”。