Microsoft 365 中的名称发音功能允许用户录制其名称发音方式的音频文件。 使用 Microsoft Graph 名称发音 API，可以启用、禁用或获取在组织中管理名称发音的设置。 例如，可以控制用户在用户自己创建的发音组织中的显示。
正确称呼某人的名字显示了包容和尊重，因为姓名是一个人身份的重要组成部分。 通过共享其名称的发音方式，用户可以帮助其他人避免假设如何处理它们，尤其是在第一次交互期间。 在混合、多元文化的工作或学校环境中，正确说出名字的简单行为可以帮助建立信任和改善沟通。
管理员可以使用Microsoft图形 API为组织中的每个人启用或禁用名称发音。 默认情况下，名称发音处于禁用状态。
在组织中启用名称发音时：
- 用户可以选择在桌面版和 Web 版的 Teams 和 Outlook 中卡配置文件中添加和管理发音。
- 名称发音在 Teams 中的配置文件卡上显示用户的姓名。
- 发音仅在组织内部显示。 在多租户组织中，所有租户中的用户可以访问任何其他租户中的用户提供的发音。
- 在组织中拥有帐户（包括来宾帐户）的任何人都可以在个人资料卡上看到发音。
名称发音数据存储在用户的邮箱中。 有关详细信息，请参阅Exchange Online Data Residency。
管理员可以决定是否显示用户在个人资料卡中设置的发音。 若要启用显示用户创建的名称发音，请将 namePronunciationSettings 对象的 isEnabledInOrganization 属性设置为 true。 当此属性设置为 true时，将显示组织内每个人的发音。 当此属性设置为 false时，不会为组织内部或外部的任何人显示发音。 默认设置为 false。
重要
打开或关闭名称发音时，用户可能需要长达 7 小时才能看到更改。 例如，如果打开发音，用户可能不会看到在个人资料卡添加录制内容的选项，最长 7 小时。 如果关闭发音，以前设置的任何录制内容可能会在 Microsoft 365 (（例如，在个人资料卡上) 最多 7 小时）保持可见。
当管理员关闭名称发音时，将触发删除过程，并且用户创建的所有发音数据都将开始删除。 删除名称发音数据最多可能需要 30 天。 如果在该时间段内重新打开发音，则在删除信号之前存在且尚未从Microsoft服务器中删除的任何录制都将重新浮出水面，并在配置文件卡上的Microsoft 365 体验中可见。
使用 Microsoft Graph REST API 配置名称发音设置
可以使用 namePronunciationSettings 资源及其关联方法在组织中配置名称发音设置。
确认当前名称发音设置
获取 namePronunciationSettings API 返回组织中名称发音的当前设置。
使用以下 HTTP 请求检索所有当前设置，包括禁用了名称发音的设置。
GET https://graph.microsoft.com/beta/admin/people/namePronunciation
如果成功， 200 OK 则返回响应代码，响应正文中包含 namePronunciationSettings 对象，如以下示例响应所示。
HTTP/1.1 200 OK
Content-Type: application/json
{
"isEnabledInOrganization": false
}
在组织中启用名称发音
将 namePronunciationSettings 对象的 isEnabledInOrganization 属性设置为true在组织中启用名称发音。
使用 Update namePronunciationSettings 方法启用名称发音，如以下示例所示：
PATCH https://graph.microsoft.com/beta/admin/people/namePronunciation
Content-Type: application/json
{
"isEnabledInOrganization": true
}
如果成功， 200 OK 则返回响应代码，响应正文中包含 namePronunciationSettings 对象，如以下示例响应所示。
HTTP/1.1 200 OK
Content-Type: application/json
{
"isEnabledInOrganization": true
}
在组织中禁用名称发音
设置 namePronunciationSettings 资源的 isEnabledInOrganization 属性，使false名称发音在组织中不可用。
使用 Update namePronunciationSettings 方法禁用名称发音，如以下示例所示。
PATCH https://graph.microsoft.com/beta/admin/people/namePronunciation
Content-Type: application/json
{
"isEnabledInOrganization": false
}
如果成功， 200 OK 则返回响应代码，响应正文中包含 namePronunciationSettings 对象，如以下示例响应所示。
HTTP/1.1 200 OK
Content-Type: application/json
{
"isEnabledInOrganization": false
}