邀请资源类型
命名空间:microsoft.graph
表示一个邀请,该邀请用于将外部用户作为Microsoft Entra企业到企业 (Microsoft Entra B2B) 协作的一部分添加到组织。
邀请进程使用以下流程:
- 创建邀请
- 将邀请发送至邀请的用户(包含邀请链接)
- 邀请的用户单击邀请链接、登录并兑现邀请和创建用户实体表示邀请的用户完成操作
- 兑现完成后,将用户重定向至指定页面
创建邀请将返回响应中的兑换 URL, (inviteRedeemUrl) 。 通过将 sendInvitationMessage 设置为 true,创建邀请 API 可以自动向邀请的用户发送包含兑现 URL 的电子邮件。 还可以自定义发送给受邀用户的消息。 反之,如果想要通过一些其他的方法发送兑现 URL,则可以将 sendInvitationMessage 设置为 false,然后使用响应中的兑现 URL 创建自己的通信。 目前,没有用于执行兑换过程的 API。 邀请的用户必须单击在上述步骤中的通信中发送的 inviteRedeemUrl 链接,并在浏览器中进行交互式兑现流程。 完成后,邀请的用户即成为组织中的外部用户。
方法
方法 | 返回类型 | 说明 |
---|---|---|
创建邀请 | 邀请 | 写入 invitation 对象的属性和关系。 |
属性
属性 | 类型 | 说明 |
---|---|---|
invitedUserDisplayName | String | 被邀请的用户的显示名称。 |
invitedUserEmailAddress | String | 被邀请的用户的电子邮件地址。 必需。 电子邮件地址中不允许使用以下特殊字符:
但是,存在下列例外情况:
|
invitedUserMessageInfo | invitedUserMessageInfo | 要发送至邀请用户的邮件的其他配置,其中包括自定义邮件文本、语言和抄送收件人列表。 |
invitedUserType | String | 被邀请的用户的 userType。 默认情况下,此操作为 Guest 。 你可以邀请你,就像你是公司管理员一样 Member 。 |
inviteRedirectUrl | String | 兑换邀请后,用户应重定向到的 URL。 必填。 |
inviteRedeemUrl | String | 用户可用于兑换邀请的 URL。 只读。 |
resetRedemption | 布尔值 | 重置用户的兑换状态并重新邀请用户,同时保留其用户标识符、组成员身份和应用分配。 此属性允许用户使用与上一个邀请中的电子邮件地址不同的电子邮件地址登录。 有关使用此属性的详细信息,请参阅 重置来宾用户的兑换状态。 |
sendInvitationMessage | Boolean | 指示电子邮件是否应发送至邀请的用户。 默认值为 false 。 |
status | String | 邀请的状态。 可能的值为: PendingAcceptance 、 Completed 、 InProgress 和 Error 。 |
关系
关系 | 类型 | 说明 |
---|---|---|
invitedUser | 用户 | 创建为邀请创建进程组成部分的用户。 只读 |
JSON 表示形式
下面是资源的 JSON 表示形式
{
"invitedUserDisplayName": "string",
"invitedUserEmailAddress": "string",
"invitedUserMessageInfo": {"@odata.type": "microsoft.graph.invitedUserMessageInfo"},
"sendInvitationMessage": false,
"inviteRedirectUrl": "string",
"inviteRedeemUrl": "string",
"resetRedemption": false,
"status": "string",
"invitedUser": {"@odata.type": "microsoft.graph.user"},
"invitedUserType": "string"
}
反馈
https://aka.ms/ContentUserFeedback。
即将推出:在整个 2024 年,我们将逐步取消以“GitHub 问题”作为内容的反馈机制,并将其替换为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈