管理重点收件箱Manage Focused Inbox

命名空间:microsoft.graphNamespace: microsoft.graph

通过重点收件箱,你可以查看收件箱的 Focused 选项卡中的重要邮件和 Other 选项卡中的其余收件箱邮件。分类系统最初按照默认方式组织收件箱邮件。可以随着时间推移通过用户界面或以编程方式对系统进行更正和培训。使用地越多,系统越能更好地推断哪些传入邮件是重要的。Focused Inbox allows you to view important messages in the Focused tab of the Inbox, and the rest of the Inbox messages in the Other tab. The classification system initially organizes Inbox messages in a default way. You can correct and train the system over time through the user interface or programmatically. The more you use it, the better the system can infer which incoming message as important.

在编程级别,重点收件箱 REST API 适用于指定用户的邮件,并支持每个邮件的 inferenceClassification 属性。可能的值为 FocusedOther,分别指示用户是否将邮件视为较重要和不太重要。若要更正系统对邮件进行分类的方式,请 更新此邮件的 inferenceClassification 属性。随着时间的推移,这些更正也能对邮件分类系统进行培训。At the programmatic level, the Focused Inbox REST API works on the specified user's messages, and supports an inferenceClassification property for each message. The possible values are Focused and Other, which indicate whether the user considers that message as, respectively, more important and less important. To correct how the system classifies a message, update the inferenceClassification property of that message. Over time, these corrections also train the message classification system.

重点收件箱 REST API 还使你能够创建替代。由 inferenceClassificationOverride 实例表示的每个替代,会指示分类系统始终以一致的方式指定来自特定发件人的邮件(即,始终作为“重点”或“其他”),而与任何以前的学习方法无关。可以 创建列出更新删除 指定用户的替代。可以在 inferenceClassification 导航属性中访问该用户的替代(如有),这些替代是 inferenceClassificationOverride 实例的集合。替代使用户能够更好地控制传入邮件的分类,并提高分类系统的可靠性。The Focused Inbox REST API also lets you create overrides. Each override, represented by an inferenceClassificationOverride instance, is an instruction for the classification system to always designate messages from a specific sender in a consistent way (i.e., always as "Focused" or always as "Other"), regardless of any previously learned approach. You can create, list, update and delete overrides for the specified user. That user's overrides, if any, are accessible in an inferenceClassification navigation property, which is a collection of inferenceClassificationOverride instances. Overrides allow a user more control over the classification of incoming messages, and build greater trust of the classification system.

注意,分类系统学习分类并仅对收件箱中的传入邮件应用分类。默认情况下,其他文件夹中的邮件为“重点”邮件。设置替代会影响以后到达收件箱的邮件;替代不会修改任意文件夹(包括收件箱)中现有邮件的 inferenceClassification 属性。Note that the classification system learns and applies classification only on incoming messages in the Inbox. Messages in other folders are by default "Focused". Setting up an override affects future messages arriving in the Inbox; the override doesn't modify the inferenceClassification property in existing messages in any folder including the Inbox.

重点收件箱 APIFocused Inbox API

对邮件分类系统进行培训Training the message classification system

更新邮件的 inferenceClassification 属性Update the inferenceClassification property of a message

使用替代对每个发件人一致分类Using overrides to classify consistently per sender

创建发件人替代 | 列出所有用户替代 |Create an override for a sender | List all user overrides |

更新发件人替代 | 删除发件人替代Update an override for a sender | Delete a sender override