Поделиться через


Создание virtualEventRegistration

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

Важно!

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

Создайте запись регистрации для участника вебинара. Этот метод регистрирует пользователя для вебинара.

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

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

Разрешения

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

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

HTTP-запрос

POST /solutions/virtualEvents/webinars/{webinarId}/registrations

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

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

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

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

При создании virtualEventRegistration с делегированным разрешением можно указать следующие свойства.

Свойство Тип Описание
preferredTimezone String Сведения о часовом поясе регистранта. Обязательно.
preferredLanguage String Предпочтительный язык регистранта. Обязательно.
registrationQuestionAnswers коллекция virtualEventRegistrationQuestionAnswer Ответ регистранта на вопросы о регистрации. Необязательный параметр.

При создании virtualEventRegistration с разрешением приложения можно указать следующие свойства.

Свойство Тип Описание
firstName String Имя регистранта. Обязательно.
lastName String Фамилия регистранта. Обязательно.
email String Адрес электронной почты регистранта. Обязательно.
preferredTimezone String Сведения о часовом поясе регистранта. Обязательно.
preferredLanguage String Предпочтительный язык регистранта. Обязательно.
registrationQuestionAnswers коллекция virtualEventRegistrationQuestionAnswer Ответ регистранта на вопросы о регистрации. Необязательный параметр.

Отклик

В случае успешного выполнения это действие возвращает одно из следующих значений:

  • Код 201 Created ответа и объект virtualEventRegistration для делегированных разрешений.
  • Код 204 No Content ответа для разрешений приложения.

Примеры

Пример 1. Создание записи регистрации с делегированным разрешением

Используйте делегированное разрешение, чтобы создать запись регистрации для пользователя с идентификатором Microsoft Entra в качестве способа регистрации пользователя Microsoft Entra на вебинаре.

Запрос

Ниже показан пример запроса.

POST https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrations
Content-Type: application/json

{
  "preferredTimezone":"Pacific Standard Time",
  "preferredLanguage":"en-us",
  "registrationQuestionAnswers": [
    {
      "questionId": "95320781-96b3-4b8f-8cf8-e6561d23447a",
      "value": null,
      "booleanValue": null,
      "multiChoiceValues": [
        "Seattle"
      ]
    },
    {
      "questionId": "4577afdb-8bee-4219-b482-04b52c6b855c",
      "value": null,
      "booleanValue": true,
      "multiChoiceValues": []
    },
    {
      "questionId": "80fefcf1-caf7-4cd3-b8d7-159e17c47f20",
      "value": null,
      "booleanValue": null,
      "multiChoiceValues": [
        "Cancun",
        "Hoboken",
        "Beijing"
      ]
    }
  ]
}

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.virtualEventRegistration",
  "id": "127962bb-84e1-7b62-fd98-1c9d39def7b6",
  "userId": "String",
  "firstName": "Emilee",
  "lastName": "Pham",
  "email": "EmileeMPham@contoso.com",
  "status": "registered",
  "registrationDateTime": "2023-03-07T22:04:17",
  "cancelationDateTime": null,
  "preferredTimezone":"Pacific Standard Time",
  "preferredLanguage":"en-us",
  "registrationQuestionAnswers": [
    {
      "questionId": "95320781-96b3-4b8f-8cf8-e6561d23447a",
      "displayName": "Which city do you currently work in?",
      "value": null,
      "booleanValue": null,
      "multiChoiceValues": [
        "Seattle"
      ]
    },
    {
      "questionId": "4577afdb-8bee-4219-b482-04b52c6b855c",
      "displayName": "Do you live in the same city where you work?",
      "value": null,
      "booleanValue": true,
      "multiChoiceValues": []
    },
    {
      "questionId": "80fefcf1-caf7-4cd3-b8d7-159e17c47f20",
      "displayName": "Which cities have you worked in?",
      "value": null,
      "booleanValue": null,
      "multiChoiceValues": [
        "Cancun",
        "Hoboken",
        "Beijing"
      ]
    }
  ]
}

Пример 2. Создание записи регистрации с разрешением приложения

Используйте разрешение приложения, чтобы создать запись регистрации для пользователя, у которого нет идентификатора Microsoft Entra , в качестве способа регистрации анонимного пользователя для вебинара.

Запрос

Ниже показан пример запроса.

POST https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrations
Content-Type: application/json

{
  "firstName" : "Diane",
  "lastName" : "Demoss",
  "email" : "DianeDemoss@contoso.com",
  "preferredTimezone":"Pacific Standard Time",
  "preferredLanguage":"en-us",
  "registrationQuestionAnswers": [
    {
      "questionId": "95320781-96b3-4b8f-8cf8-e6561d23447a",
      "value": null,
      "booleanValue": null,
      "multiChoiceValues": [
        "Seattle"
      ]
    },
    {
      "questionId": "4577afdb-8bee-4219-b482-04b52c6b855c",
      "value": null,
      "booleanValue": true,
      "multiChoiceValues": []
    },
    {
      "questionId": "80fefcf1-caf7-4cd3-b8d7-159e17c47f20",
      "value": null,
      "booleanValue": null,
      "multiChoiceValues": [
        "London",
        "New York City"
      ]
    }
  ]
}

Отклик

Ниже приводится пример отклика.

HTTP/1.1 204 No Content