Создание meetingRegistrant

  • Статья

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Регистрация регистранта собрания в собрании по сети с включенной регистрацией собрания от имени регистранта. Эта операция имеет два сценария:

  • Если значение свойства allowedRegistrant объекта meetingRegistration равно organization, регистрантам потребуется выполнить вход перед регистрацией на собрание. FirstName, lastName и email должны соответствовать сведениям, хранящимся в Microsoft Entra ID.
  • Если значение свойства allowedRegistrant объекта meetingRegistration равно everyone, регистранты не будут обязаны выполнять вход и будут считаться анонимными.

В любом случае регистрант получит уведомление по электронной почте, содержащее сведения о регистрации.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet
✅ ❌ ❌ ❌

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) OnlineMeetings.ReadWrite Недоступно.
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Приложение OnlineMeetings.Read.All OnlineMeetings.ReadWrite.All

Совет

  • Если значение свойства allowedRegistrant объекта meetingRegistration равно organization, используйте делегированное разрешение регистранта на регистрацию.
  • Если значение свойства allowedRegistrant объекта meetingRegistration равно everyone, используйте делегированное разрешение регистранта на регистрацию.

HTTP-запрос

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

Примечание:userId — это идентификатор объекта организатора собрания.

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.

Текст запроса

В тексте запроса укажите представление в формате JSON редактируемых свойств объекта meetingRegistrant .

Важно!

Чтобы указать тип регистранта, необходимо указать свойство @odata.type . Дополнительные сведения см. в следующем примере.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 200 OK и частичный объект meetingRegistrant в тексте ответа.

Совет

Текст ответа будет содержать разные сведения в зависимости от значения allowedRegistrant.

  • Если значение свойства allowedRegistrant равно organization, в объекте meetingRegistrant будут возвращены только идентификаторы и joinWebUrl. Регистранты могут использовать идентификатор для отмены регистрации или присоединиться кWebUrl для присоединения к собранию.
  • Если значение свойства allowedRegistrant равно everyone, возвращается пустой объект meetingRegistrant . Регистранты должны использовать ссылки в сообщении электронной почты, которое они получают, чтобы отменить регистрацию или присоединиться к собранию.

Примеры

Пример 1. Регистрация вошедшего регистратора

В следующем примере показано, как зарегистрировать вошедшего регистранта с делегированным разрешением регистранта, если собрание разрешилоРегистранту присвоено значение 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. Регистрация анонимного регистратора

В следующем примере показано, как зарегистрировать анонимного регистратора с разрешением приложения, если собрание разрешилоРегистранту задано значение 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": []
}