通过

创建 meetingRegistrant (已弃用)

命名空间：microsoft.graph

重要

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

警告

会议注册 API 已弃用，将于 2024 年 12 月 12 日停止返回数据。 请使用新的 网络研讨会 API。 有关详细信息，请参阅 弃用 Microsoft Graph 会议注册 beta API。

在代表 注册人 启用了 会议注册 的联机会议中注册会议注册人。 此操作有两种方案：

  • 如果 meetingRegistration 对象的 organizationallowedRegistrant 属性的值为 ，则注册者在注册会议之前需要登录。 firstName、lastName 和 email 必须与存储在 Microsoft Entra ID 中的信息匹配。
  • 如果 meetingRegistration 对象的 everyoneallowedRegistrant 属性的值为 ，则注册者无需登录，并且将被视为匿名。

在任一方案中，注册者都将收到包含其注册信息的电子邮件通知。

此 API 可用于以下国家级云部署。

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国
✅ ❌ ❌ ❌

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时，才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息，请参阅权限类型。 要了解有关这些权限的详细信息，请参阅 权限参考。

权限类型 最低特权权限 更高特权权限
委派（工作或学校帐户） OnlineMeetings.ReadWrite 不可用。
委派（个人 Microsoft 帐户） 不支持。 不支持。
应用程序 OnlineMeetings.Read.All OnlineMeetings.ReadWrite.All

提示

  • 如果 meetingRegistration 对象的 organizationallowedRegistrant 属性的值为 ，请使用注册者的委托权限进行注册。
  • 如果 meetingRegistration 对象的 everyoneallowedRegistrant 属性的值为 ，请使用注册者的委托权限进行注册。

HTTP 请求

POST /users/{userId}/onlineMeetings/{id}/registration/registrants

注意：userId 是会议组织者的 objectID 。

请求标头

名称 说明
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权。

请求正文

在请求正文中，提供 meetingRegistrant 对象的可编辑属性的 JSON 表示形式。

重要

必须提供 @odata.type 属性才能指定注册类型。 有关详细信息，请参阅 以下示例。

响应

如果成功，此方法在响应正文中返回响应 200 OK 代码和部分 meetingRegistrant 对象。

提示

响应正文将包含不同的信息，具体取决于 allowedRegistrant 的值。

  • 如果 allowedRegistrant 属性organization的值为 ，则 meetingRegistrant 对象中仅返回 id 和 joinWebUrl。 注册者可以使用 ID 取消其注册或 joinWebUrl 加入会议。
  • 如果 allowedRegistrant 属性 everyone的值为 ，则将返回空 meetingRegistrant 对象。 注册者需要使用收到的电子邮件中的链接来取消注册或加入会议。

示例

示例 1：注册已登录的注册人

以下示例演示如何在会议将 allowedRegistrant 设置为 organization时，使用注册者的委托权限注册已登录的注册者。

请求

POST https://graph.microsoft.com/beta/users/16664f75-11dc-4870-bec6-38c1aaa81431/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZ/registration/registrants
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.meetingRegistrant",
  "firstName": "Frederick",
  "lastName": "Cormier",
  "email": "frederick.cormier@contoso.com",
  "customQuestionAnswers": [
    {
      "questionId": "MSM5YjlmM2Q4ZS03ZmVkLTRmN3gwMDIw94MDAyMF9hX3gwMDIwX2RldmU=",
      "value": "No"
    },
    {
      "questionId": "MSM5M2E2OWQ1Ni1jZTc4LTQDAwMjBfZGlkX3gwMDIwX3lvdV94MDAyMF8=",
      "value": "Internet"
    }
  ]
}

响应

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('16664f75-11dc-4870-bec6-38c1aaa81431')/onlineMeetings('MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZ')/registration/registrants/$entity",
  "@odata.type": "#microsoft.graph.meetingRegistrant",
  "id": "gWWckDBR6UOI8_yzWCzeNw,6pAAiSU1bkGqzLnbHG_muA,bzLh6uR-5EGYsCvtvIvs6Q,E4jbleVFdE6BDf6ei3YBOA,KvXQzK4zfU-5LQj_ZLWgow,A7_SArco00S-Qr707l0vBA,UFakyZrk1K9vBacExW1muA",
  "registrationDateTime": null,
  "joinWebUrl": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_MmE4Mzg1OTItYjg2Ni00ZmNmLWI5NjMtODNkZDJiMWNlNTVi%40thread.v2/0?context=%7b%22Tid%22%3a%22909c6581-5131-43e9-88f3-fcb3582cde37%22%2c%22Oid%22%3a%22dc17674c-81d9-4adb-bfb2-8f6a442e4622%22%2c%22prid%22%3a%22gWWckDBR6UOI8_yzWCzeNw%2c6pAAiSa1bkGqzLnbHG_muA%2cbzLh6uR-5EGdsCvtvIvs6Q%2cE4jbleVFdE6BDf6ei3YBOA%2cKvXQzK4zfU-5LQj_ZLWgow%2cA7_SArco00S-Qr707l0vBA%2cUFaiyZrk1K9vBacExW1muA%22%2c%22isPublic%22%3afalse%7d",
  "firstName": null,
  "lastName": null,
  "email": null,
  "status": null,
  "customQuestionAnswers": []
}

示例 2：注册匿名注册者

以下示例演示如何在会议 allowedRegistrant 设置为 everyone时注册具有应用程序权限的匿名注册者。

请求

POST https://graph.microsoft.com/beta/users/dc17674c-81d9-4adb-bfb2-8f6a442e4622/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZ/registration/registrants
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.meetingRegistrant",
  "firstName": "Lisa",
  "lastName": "Adkins",
  "email": "lisa.adkins@contoso.com",
  "customQuestionAnswers": [
    {
      "questionId": "MSM5YjlmM2Q4ZS03ZmVkLTRmN3gwMDIw94MDAyMF9hX3gwMDIwX2RldmU=",
      "value": "No"
    },
    {
      "questionId": "MSM5M2E2OWQ1Ni1jZTc4LTQDAwMjBfZGlkX3gwMDIwX3lvdV94MDAyMF8=",
      "value": "Internet"
    }
  ]
}

响应

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('16664f75-11dc-4870-bec6-38c1aaa81431')/onlineMeetings('MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZ')/registration/registrants/$entity",
    "@odata.type": "#microsoft.graph.meetingRegistrant",
    "id": "",
    "registrationDateTime": null,
    "joinWebUrl": "",
    "firstName": null,
    "lastName": null,
    "email": null,
    "status": null,
    "customQuestionAnswers": []
}