通过

Office 365 用户

Office 365 用户连接提供程序允许你使用 Office 365 帐户访问组织中的用户配置文件。 可以执行各种作，例如获取配置文件、用户配置文件、用户的经理或直接报告，以及更新用户配置文件。

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

服务 Class 区域
Copilot Studio 标准 所有 Power Automate 区域
逻辑应用程序 标准 所有 逻辑应用区域
Power Apps 标准 所有 Power Apps 区域
Power Automate 标准 所有 Power Automate 区域
联系人​​
Name Office 365 用户
URL https://dori-uw-1.kuma-moon.com/en-us/connectors/office365users/
Email idcknowledgeeco@microsoft.com
连接器元数据
发布者 Microsoft
Website https://www.office.com/
隐私策略 https://privacy.microsoft.com/
类别 人工智能;商业智能

若要在 Power Apps 中使用此连接器， 请在此处了解详细信息。

已知问题和限制

以下是使用 Office 365 用户连接器的一些已知限制。

  1. 若要使用此集成，需要访问已启用 REST API 的 Office 365 邮箱。 若要建立连接，请选择“ 登录”。 系统将提示你提供 Office 365 帐户，按照屏幕的其余部分创建连接。
  2. 连接器不支持 LogicApps 美国政府云中的政府社区云高（GCCH）帐户。
  3. 如果使用连接器看到错误，请检查是否已启用 REST API。 专用（本地）邮件服务器或沙盒（测试）帐户上的帐户也可能看到错误。 管理员可在此处了解如何迁移邮箱。 此外，如果使用 EWS 应用程序访问策略，请确保允许以下用户代理：“LogicAppsDesigner/*”，“azure-logic-apps/*”，“PowerApps/*”、“Mozilla/*”
  4. 获取管理器 （V2） 作返回“找不到指定用户的经理”。
    • 如果用户未在 Microsoft entra ID 中配置管理器，则会发生此情况。 了解如何更新 Microsoft Entra ID 用户的配置文件以 在此处配置管理器。
  5. 获取直接报告（V2）、 获取管理器（V2）、 获取我的配置文件（V2） 和 获取用户配置文件（V2） 作声明输入参数 Select fields。 可以指定要在此参数中选择的昏迷分隔字段列表（ 在此处了解有关可用字段的详细信息）。 例如：
    • department, jobTitle
    • displayName, surname, mailNickname, userPrincipalName
  6. 如果未指定参数，则默认选择以下字段：aboutMe、 accountEnabled， 生日， businessPhones， city， companyName， country， department， displayName， givenName， hireDate， id， interests， jobTitle， mailNickname， mobilePhone， mySite， officeLocation， pastProjects， postalCode， preferredLanguage， preferredName， responsibilities， schools， skills， state， streetAddress， surname， userPrincipalName， userType.
  7. 获取直接报告（V2）、 获取管理器（V2）、 获取我的配置文件（V2） 和 “获取用户配置文件”（V2） 作可能会失败 403 Forbidden ，如果租户策略阻止了默认情况下选择的某些字段（如上所述）。 请联系租户管理员以允许列出字段，或尝试显式指定 Select fields 参数。
    • 确保 除外部用户之外的所有用户 都有权 My Site Host 访问 SharePoint 管理中心中的“我的设置”和“权限”部分，以便查询默认情况下选择的字段，如上所述。
  8. 条件访问策略可以防止连接器按预期运行。 错误示例：“AADSTS53003：条件访问策略阻止了访问。 访问策略不允许颁发令牌。” 有关更多详细信息 ，请参阅Microsoft Entra ID 条件访问文档 。
  9. 获取我的个人资料（V2） 作可能会失败，来宾用户使用时出错 401 Unauthorized 。 若要解决此问题，请尝试显式指定 Select fields 参数： id, displayName, givenName, surname, mail, mailNickname, accountEnabled, userPrincipalName, department, jobTitle, mobilePhone, businessPhones, city, companyName, country, officeLocation, postalCode.
  10. SearchUser （v2） 可能会失败并 403 Insufficient privileges to complete the operation 出现错误。
    • 来宾用户受设计限制。 另一种建议是创建由 SharePoint 上的 Office365 用户列表填充的用户列表，然后将此列表用作数据源。
    • 此外，限制来宾的访问权限可以增强组织的信息安全。 建议评估此作的安全影响。

创建连接

连接器支持以下身份验证类型：
默认 用于创建连接的参数。 所有区域 不可共享

违约

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

限制

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

操作

发送 HTTP 请求

构造要调用的Microsoft图形 REST API 请求。 支持以下段：第 1 节：/me、/users/<userId> 第二段：messages、mailFolders、events、calendar、calendars、outlook、inferenceClassification。 了解详细信息：https://docs.microsoft.com/en-us/graph/use-the-api。
搜索用户 [已弃用]

此作已弃用。 请改用搜索用户（V2）。

检索与搜索词匹配的用户配置文件。
搜索用户（V2）

检索与搜索词（V2）匹配的用户配置文件。
更新个人资料照片

更新当前用户的个人资料照片。 照片的大小必须小于 4 MB。
更新我的个人资料

更新当前用户的配置文件
获取我的个人资料 （V1） [已弃用]

此作已弃用。 请改用“获取我的个人资料”（V2）。

检索当前用户的配置文件。
获取我的个人资料 （V2）

检索当前用户的配置文件。 详细了解要选择的可用字段： https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties
获取热门文档

检索已登录用户的热门文档
获取热门文档

检索用户的热门文档
获取用户照片 （V1） [已弃用]

此作已弃用。 请改用“获取用户照片”（V2）。

检索指定用户的照片（如果有）。
获取用户照片 （V2）

检索指定用户的照片（如果有）
获取用户照片元数据

获取用户照片元数据。
获取用户配置文件 （V1） [已弃用]

此作已弃用。 请改用“获取用户配置文件”（V2）。

检索特定用户的配置文件。
获取用户配置文件 （V2）

检索特定用户的配置文件。 详细了解要选择的可用字段： https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties
获取直接报告 （V1） [已弃用]

此作已弃用。 请改用“获取直接报告”（V2）。

检索指定用户的直接报表的用户配置文件。
获取直接报告 （V2）

检索指定用户的直接报表的用户配置文件。 详细了解要选择的可用字段： https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties
获取相关人员

获取相关人员。
获取经理 （V1） [已弃用]

此作已弃用。 请改用 Get Manager （V2）。

检索指定用户的管理器的配置文件。
获取经理 （V2）

检索指定用户的管理器的配置文件。 详细了解要选择的可用字段： https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties

发送 HTTP 请求

操作 ID:
HttpRequest

构造要调用的Microsoft图形 REST API 请求。 支持以下段：第 1 节：/me、/users/<userId> 第二段：messages、mailFolders、events、calendar、calendars、outlook、inferenceClassification。 了解详细信息：https://docs.microsoft.com/en-us/graph/use-the-api。

参数

名称 密钥 必需 类型 说明
URI
 Uri True string

完整或相对 URI。 示例：https://graph.microsoft.com/{version}/{resource}。
方法
 Method True string

HTTP 方法（默认值为 GET）。
Body
 Body binary

请求正文内容。
Content-Type
 ContentType string

正文的内容类型标头（默认值为 application/json）。
CustomHeader1
 CustomHeader1 string

自定义标头 1。 以格式指定：header-name： header-value
CustomHeader2
 CustomHeader2 string

自定义标头 2。 以格式指定：header-name： header-value
CustomHeader3
 CustomHeader3 string

自定义标头 3。 以格式指定：header-name： header-value
CustomHeader4
 CustomHeader4 string

自定义标头 4。 以格式指定：header-name： header-value
CustomHeader5
 CustomHeader5 string

自定义标头 5。 以格式指定：header-name： header-value

返回

response
ObjectWithoutType

搜索用户 [已弃用]

操作 ID:
SearchUser

此作已弃用。 请改用搜索用户（V2）。

检索与搜索词匹配的用户配置文件。

参数

名称 密钥 必需 类型 说明
搜索词
 searchTerm string

搜索字符串（适用于：显示名称、给定名称、姓氏、邮件、邮件别名和用户主体名称）。
Top
 top integer

要返回的结果数的限制。 默认情况下返回所有条目。

返回

response
array of User

搜索用户（V2）

操作 ID:
SearchUserV2

检索与搜索词（V2）匹配的用户配置文件。

参数

名称 密钥 必需 类型 说明
搜索词
 searchTerm string

搜索字符串（适用于：显示名称、给定名称、姓氏、邮件、邮件别名和用户主体名称）。
Top
 top integer

要返回的结果数的限制。 最小值为 1。 默认值为 1000。
是否需要搜索词
 isSearchTermRequired boolean

如果设置为“是”，则搜索词为空时不会返回任何用户配置文件。 如果设置为“否”，则搜索词为空时不会应用筛选。

返回

表示来自 Office API 的实体列表响应的类。

Body
EntityListResponse[IReadOnlyList[User]]

更新个人资料照片

操作 ID:
UpdateMyPhoto

更新当前用户的个人资料照片。 照片的大小必须小于 4 MB。

参数

名称 密钥 必需 类型 说明
图像内容
 body True binary

图像内容
Content-Type
 Content-Type True string

图像内容类型（如“image/jpeg”）

更新我的个人资料

操作 ID:
UpdateMyProfile

更新当前用户的配置文件

参数

名称 密钥 必需 类型 说明
关于我
 aboutMe string

关于我
生日
 birthday date-time

生日
利益
 interests array of string

利益
我的网站
 mySite string

我的网站
过去的项目
 pastProjects array of string

过去的项目
学校
 schools array of string

学校
Skills
 skills array of string

Skills

获取我的个人资料 （V1） [已弃用]

操作 ID:
MyProfile

此作已弃用。 请改用“获取我的个人资料”（V2）。

检索当前用户的配置文件。

返回

表示目录中的 User 对象

Body
User

获取我的个人资料 （V2）

操作 ID:
MyProfile_V2

检索当前用户的配置文件。 详细了解要选择的可用字段： https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties

参数

名称 密钥 必需 类型 说明
选择字段
 $select string

要选择的字段的逗号分隔列表。 示例：surname、department、jobTitle

返回

图形 API 中的用户

Body
GraphUser_V1

获取热门文档

操作 ID:
MyTrendingDocuments

检索已登录用户的热门文档

参数

名称 密钥 必需 类型 说明
筛选查询
 $filter string

用于筛选所选资源的 OData 筛选器。 在 ResourceVisualization/Type 或 ResourceVisualization/containerType 上筛选所选资源
提取敏感度标签
 extractSensitivityLabel boolean

如果要提取敏感度标签（false，true），请选择。
敏感度标签元数据
 fetchSensitivityLabelMetadata boolean

是否提取关联 LabelId 的敏感度标签元数据的布尔值。

返回

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

value

获取热门文档

操作 ID:
TrendingDocuments

检索用户的热门文档

参数

名称 密钥 必需 类型 说明
用户（UPN）
 id True string

用户主体名称或 ID。
筛选查询
 $filter string

用于筛选所选资源的 OData 筛选器。 在 ResourceVisualization/Type 或 ResourceVisualization/containerType 上筛选所选资源
提取敏感度标签
 extractSensitivityLabel boolean

如果要提取敏感度标签（false，true），请选择。
敏感度标签元数据
 fetchSensitivityLabelMetadata boolean

是否提取关联 LabelId 的敏感度标签元数据的布尔值。

返回

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

value

获取用户照片 （V1） [已弃用]

操作 ID:
UserPhoto

此作已弃用。 请改用“获取用户照片”（V2）。

检索指定用户的照片（如果有）。

参数

名称 密钥 必需 类型 说明
用户（UPN）
 userId True string

用户主体名称或 ID。

返回

图像文件内容
binary

获取用户照片 （V2）

操作 ID:
UserPhoto_V2

检索指定用户的照片（如果有）

参数

名称 密钥 必需 类型 说明
用户（UPN）
 id True string

用户主体名称或 ID。

返回

图像文件内容
binary

获取用户照片元数据

操作 ID:
UserPhotoMetadata

获取用户照片元数据。

参数

名称 密钥 必需 类型 说明
用户（UPN）
 userId True string

用户主体名称或 ID。

返回

照片元数据类

Body
ClientPhotoMetadata

获取用户配置文件 （V1） [已弃用]

操作 ID:
UserProfile

此作已弃用。 请改用“获取用户配置文件”（V2）。

检索特定用户的配置文件。

参数

名称 密钥 必需 类型 说明
用户（UPN）
 userId True string

用户主体名称或 ID。

返回

表示目录中的 User 对象

Body
User

获取用户配置文件 （V2）

操作 ID:
UserProfile_V2

检索特定用户的配置文件。 详细了解要选择的可用字段： https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties

参数

名称 密钥 必需 类型 说明
用户（UPN）
 id True string

用户主体名称或 ID。
选择字段
 $select string

要选择的字段的逗号分隔列表。 示例：surname、department、jobTitle

返回

图形 API 中的用户

Body
GraphUser_V1

获取直接报告 （V1） [已弃用]

操作 ID:
DirectReports

此作已弃用。 请改用“获取直接报告”（V2）。

检索指定用户的直接报表的用户配置文件。

参数

名称 密钥 必需 类型 说明
用户（UPN）
 userId True string

用户主体名称或 ID。

返回

response
array of User

获取直接报告 （V2）

操作 ID:
DirectReports_V2

检索指定用户的直接报表的用户配置文件。 详细了解要选择的可用字段： https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties

参数

名称 密钥 必需 类型 说明
用户（UPN）
 id True string

用户主体名称或 ID。
选择字段
 $select string

要选择的字段的逗号分隔列表。 示例：surname、department、jobTitle
Top
 $top integer

要返回的结果数的限制。 默认情况下返回所有条目。

返回

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

价值

获取相关人员

操作 ID:
RelevantPeople

获取相关人员。

参数

名称 密钥 必需 类型 说明
用户（UPN）
 userId True string

用户主体名称或 ID。

返回

表示图形 API 中的列表

Body
LinklessEntityListResponse[List[Person]]

获取经理 （V1） [已弃用]

操作 ID:
Manager

此作已弃用。 请改用 Get Manager （V2）。

检索指定用户的管理器的配置文件。

参数

名称 密钥 必需 类型 说明
用户（UPN）
 userId True string

用户主体名称或 ID。

返回

表示目录中的 User 对象

Body
User

获取经理 （V2）

操作 ID:
Manager_V2

检索指定用户的管理器的配置文件。 详细了解要选择的可用字段： https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties

参数

名称 密钥 必需 类型 说明
用户（UPN）
 id True string

用户主体名称或 ID。
选择字段
 $select string

要选择的字段的逗号分隔列表。 示例：surname、department、jobTitle

返回

图形 API 中的用户

Body
GraphUser_V1

定义

GraphTrending

图形 API 中的热门文档

名称 路径 类型 说明
Id
 id string

关系的唯一标识符
Weight
 weight float

指示文档当前趋势量的值
资源可视化
 resourceVisualization resourceVisualization

resourceVisualization
sensitivityLabelInfo
 sensitivityLabelInfo array of sensitivityLabelMetadata

resourceVisualization

resourceVisualization

名称 路径 类型 说明
Title
 title string

项的标题文本
类型
 type string

项的媒体类型（可用于根据特定类型筛选特定文件）
媒体类型
 mediaType string

项媒体类型（可用于根据受支持的 IANA 媒体 MIME 类型筛选特定类型的文件）
预览图像 URL
 previewImageUrl string

指向项目预览图像的 URL
预览文本
 previewText string

项目的预览文本
容器 Web URL
 containerWebUrl string

指向在其中存储项的文件夹的路径
容器显示名称
 containerDisplayName string

描述项存储位置的字符串
容器类型
 containerType string

可用于按存储文件的容器类型进行筛选

sensitivityLabelMetadata

名称 路径 类型 说明
sensitivityLabelId
 sensitivityLabelId string

SensitivityLabel Id。
姓名
 name string

SensitivityLabel 名称。
displayName
 displayName string

SensitivityLabel displayName 信息
工具提示
 tooltip string

工具提示的 SensitivityLabel 详细信息。
priority
 priority integer

SensitivityLabel 优先级。
color
 color string

SensitivityLabel 颜色。
isEncrypted
 isEncrypted boolean

是 SensitivityLabel Encrypted。
isEnabled
 isEnabled boolean

SensitivityLabel 是否已启用。
isParent
 isParent boolean

SensitivityLabel 是否为 Parent。
parentSensitivityLabelId
 parentSensitivityLabelId string

父 SensitivityLabel Id。

LinklessEntityListResponse[List[Person]]

表示图形 API 中的列表

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

价值

人员

表示人员

名称 路径 类型 说明
人员 ID
 id string

目录中 Person 对象的唯一标识符
显示名称
 displayName string

人员的显示名称
名
 givenName string

人员的给定名称
Surname
 surname string

该人的姓氏
生日
 birthday string

此人的生日
人员备注
 personNotes string

自由格式说明当前用户已就此人进行了介绍
收藏吗？
 isFavorite boolean

如果当前用户已将此用户标记为收藏夹
职务
 jobTitle string

人员的职务
公司名称
 companyName string

人员公司的名称
Department
 department string

该人员的部门
Office 位置
 officeLocation string

人员办公室的位置
职业
 profession string

该人的职业
用户主体名称 （UPN）
 userPrincipalName string

用户的用户主体名称（UPN）。UPN 是基于 Internet 标准 RFC 822 的用户的 Internet 样式登录名。 按照约定，这应映射到用户的电子邮件名称。常规格式为别名 @domain，其中域必须存在于租户的已验证域集合中。
IM 地址
 imAddress string

人员的 VOIP SIP 地址
评分的电子邮件地址
 scoredEmailAddresses array of ScoredEmailAddress

具有相关性分数的人员电子邮件地址的集合
电话
 phones array of Phone

人员的电话号码

ScoredEmailAddress

表示评分的电子邮件地址

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

电子邮件地址
相关性分数
 relevanceScore double

电子邮件地址的相关性分数。 相关性分数用作排序键，相对于其他返回的结果。 较高的相关性分数值对应于更相关的结果。 相关性由用户的通信和协作模式以及业务关系决定。

电话

表示电话号码

名称 路径 类型 说明
电话号码
 number string

电话号码
电话类型
 type string

电话号码的类型。 可能的值：home、business、mobile、other、assistant、homeFax、businessFax、otherFax、pager、radio。

用户

表示目录中的 User 对象

名称 路径 类型 说明
用户 ID
 Id string

目录中用户对象的唯一标识符。
帐户已启用？
 AccountEnabled boolean

如果帐户已启用，则为 true;否则为 false。 创建用户时此属性是必需的。
商务电话
 BusinessPhones array of string

用户的商务电话号码列表
City
 City string

用户所在的城市。
公司名称
 CompanyName string

用户在其中工作的公司的名称。
国家
 Country string

用户所在的国家/地区;例如，“US”或“UK”。
Department
 Department string

用户在其中工作的部门的名称。
显示名称
 DisplayName string

用户通讯簿中显示的名称。 这通常是用户的名字、中间名和姓氏的组合。 创建用户且在更新期间无法清除此属性时，此属性是必需的。
名
 GivenName string

用户的名。
职务
 JobTitle string

用户的职务。
Email
 Mail string

用户的 SMTP/电子邮件地址，例如“jeff@contoso.onmicrosoft.com”。 只读。
昵称
 MailNickname string

用户的邮件别名。 创建用户时必须指定此属性。
Office 位置
 OfficeLocation string

用户公司地点的办公室位置。
邮政编码
 PostalCode string

用户邮政地址的邮政编码。 邮政编码特定于用户所在的国家/地区。 在美国，此属性包含邮政编码。
Surname
 Surname string

用户的姓氏。
电话号码
 TelephoneNumber string

用户的主要移动电话号码。
用户主体名称 （UPN）
 UserPrincipalName string

用户的用户主体名称 (UPN)。 UPN 是基于 Internet 标准 RFC 822 的用户的 Internet 样式登录名。 按照约定，这应映射到用户的电子邮件名称。 常规格式为alias@domain，其中域必须存在于租户的已验证域集合中。

ClientPhotoMetadata

照片元数据类

名称 路径 类型 说明
有照片
 HasPhoto boolean

有照片
高度
 Height integer

照片的高度
宽度
 Width integer

照片宽度
内容类型
 ContentType string

照片的内容类型
图像文件扩展名
 ImageFileExtension string

照片的文件扩展名（例如：“.jpg”）

EntityListResponse[IReadOnlyList[User]]

表示来自 Office API 的实体列表响应的类。

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

价值
@odata.nextLink
 @odata.nextLink string

下一页链接

GraphUser_V1

图形 API 中的用户

名称 路径 类型 说明
关于我
 aboutMe string

关于我
帐户已启用？
 accountEnabled boolean

如果帐户已启用，则为 true;否则为 false。 创建用户时此属性是必需的。
生日
 birthday date-time

生日
商务电话
 businessPhones array of string

商务电话
City
 city string

用户所在的城市。
公司名称
 companyName string

用户在其中工作的公司的名称。
国家
 country string

用户所在的国家/地区;例如，“US”或“UK”。
Department
 department string

用户在其中工作的部门的名称。
显示名称
 displayName string

显示名称
名
 givenName string

名
雇佣日期
 hireDate date-time

雇佣日期
Id
 id string

Id
利益
 interests array of string

利益
职务
 jobTitle string

职务
邮件
 mail string

邮件
昵称
 mailNickname string

用户的邮件别名。 创建用户时必须指定此属性。
移动电话
 mobilePhone string

移动电话
我的网站
 mySite string

我的网站
Office 位置
 officeLocation string

Office 位置
过去的项目
 pastProjects array of string

过去的项目
邮政编码
 postalCode string

用户邮政地址的邮政编码。 邮政编码特定于用户所在的国家/地区。 在美国，此属性包含邮政编码。
首选语言
 preferredLanguage string

首选语言
首选名称
 preferredName string

首选名称
职责
 responsibilities array of string

职责
学校
 schools array of string

学校
Skills
 skills array of string

Skills
State
 state string

State
街道地址
 streetAddress string

街道地址
Surname
 surname string

Surname
用户主体名称
 userPrincipalName string

用户主体名称
用户类型
 userType string

用户类型

ObjectWithoutType

二进制

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