提及资源类型

项目
06/01/2021

命名空间：microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。不支持在生产应用程序中使用这些 API。若要确定 API 是否在 v1.0 中可用，请使用版本选择器。

表示根据用户的电子邮件地址向用户发送的通知。此类型的通知也称为 @-mentions。

邮件资源支持提及。它包括 一个 mentionsPreview 属性，该属性指示是否已在邮件实例中提及登录用户。它还包括提及导航属性，该属性支持获取提及的详细信息，或删除该实例中的提及。

创建邮件时，应用可以通过将提及包括在提及属性中，在同一请求中 POST 创建提及。通过使用查询参数的请求，应用可以返回已登录用户邮箱中提及该用户 GET $filter 的所有邮件。通过 GET 查询参数 $expand 的请求，应用可以展开特定邮件中提及的所有内容。

这种允许应用在邮件中设置和提及的机制可启用轻型通知，其中进行提及的用户可以保留在现有上下文中 (例如，在应用设置基础提及属性时) 撰写邮件正文。被提及人员可以轻松找出是否通过请求或查询参数提及 GET $filter 他们以及在何处 $expand 提及他们。

例如，在 Outlook 邮件客户端中，当用户在编写邮件时进行输入时，Outlook 允许用户选择或输入名称以 @ 完成 @-mention。 Outlook 在 创建和 发送邮件或事件之前设置 mentions 属性。 Outlook 还使用与登录用户一起的操作，并允许登录用户查找提及用户的邮件，以提醒用户操作项目或讨论，从而加快 GET $filter $expand 响应速度。

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "application": "string",
  "clientReference": "string",
  "createdBy": {"@odata.type": "microsoft.graph.emailAddress"},
  "createdDateTime": "DateTimeOffset",
  "deepLink": "string",
  "id": "string (identifier)",
  "mentioned": {"@odata.type": "microsoft.graph.emailAddress"},
  "mentionText": "string",
  "serverCreatedDateTime": "DateTimeOffset"
}

属性

属性	类型	说明
application	String	创建提及项的应用程序的名称。可选。不用于邮件，并且默认为 null。
clientReference	String	表示资源实例的父级的唯一标识符。可选。不用于邮件，并且默认为 null。
createdBy	emailAddress	进行提及的用户的电子邮件信息。
createdDateTime	DateTimeOffset	在客户端上创建提及的日期和时间。
deepLink	String	指向资源实例中提及内容上下文的深层 Web 链接。可选。不用于邮件，并且默认为 null。
id	String	资源实例中提及的唯一标识符。
提及	emailAddress	被提及人员的电子邮件信息。必需。
mentionText	String	可选。不用于邮件，并且默认为 null。若要获取邮件中的提及，请参阅邮件的 bodyPreview 属性。
serverCreatedDateTime	DateTimeOffset	在服务器上创建提及的日期和时间。可选。不用于邮件，并且默认为 null。

关系

无

方法

方法	返回类型	说明
发布和发送	无	创建新邮件的一部分并发送提及。
张贴到新草稿	包含一个或多个提及对象的邮件。	创建新邮件的草稿，并包括一个或多个提及对象。
获取提及我的消息	message 集合	获取已登录用户的邮箱中包含此用户提及的所有邮件。
获取邮件及其提及内容	message 集合	获取邮件并展开邮件中每个提及的详细信息。
删除提及	无	删除登录用户邮箱中指定邮件中指定的提及内容。

提及资源类型

JSON 表示形式

属性

关系

方法

反馈