Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Пространство имен: microsoft.graph
Получение свойств и связей объекта virtualEventRegistration .
Этот API доступен в следующих национальных облачных развертываниях.
| Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
| Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
|---|---|---|
| Делегированные (рабочая или учебная учетная запись) | VirtualEvent.Read | VirtualEvent.ReadWrite |
| Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
| Приложение | VirtualEvent.Read.Chat | VirtualEvent.Read.All, VirtualEventRegistration-Anon.ReadWrite.All |
Примечание.
- Чтобы использовать разрешения приложений для этого API, администраторы клиентов должны создать политику доступа к приложениям и назначить ее пользователю. Это позволяет авторизованному приложению получать доступ к записям регистрации из виртуальных событий, созданных этим конкретным пользователем.
- Разрешение
VirtualEvent.Read.Chatиспользует согласие для конкретного ресурса.
HTTP-запрос
GET /solutions/virtualEvents/webinars/{webinarId}/registrations/{registrationId}
Необязательные параметры запросов
Этот метод поддерживает $expand параметр запроса OData для настройки ответа. Общие сведения см. в статье Параметры запроса OData.
Заголовки запросов
| Имя | Описание |
|---|---|
| Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Текст запроса
Не указывайте текст запроса для этого метода.
Отклик
В случае успешного выполнения этот метод возвращает код отклика 200 OK и объект virtualEventRegistration в теле отклика.
Примеры
Пример 1. Получение регистрации вебинара по идентификатору
В следующем примере показано, как получить регистрацию вебинара по идентификатору регистрации.
Запрос
Ниже показан пример запроса.
GET https://graph.microsoft.com/v1.0/solutions/virtualEvents/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21-a8a6-4a6b-97f8-ced53d30f143/registrations/127962bb-84e1-7b62-fd98-1c9d39def7b6
Отклик
Ниже показан пример отклика.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 200 OK
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",
"externalRegistrationInformation": {
"referrer": "Fabrikam",
"registrationId": "myExternalRegistrationId"
},
"status": "registered",
"registrationDateTime": "2023-03-07T22:04:17",
"cancelationDateTime": null,
"registrationQuestionAnswers": [
{
"questionId": "95320781-96b3-4b8f-8cf8-e6561d23447a",
"displayName": null,
"value": null,
"booleanValue": null,
"multiChoiceValues": [
"Seattle"
]
},
{
"questionId": "4577afdb-8bee-4219-b482-04b52c6b855c",
"displayName": null,
"value": null,
"booleanValue": true,
"multiChoiceValues": []
},
{
"questionId": "80fefcf1-caf7-4cd3-b8d7-159e17c47f20",
"displayName": null,
"value": null,
"booleanValue": null,
"multiChoiceValues": [
"Cancun",
"Hoboken",
"Beijing"
]
}
]
}
Пример 2. Получение регистрации вебинара по идентификатору и включение сеансов
В следующем примере показано, как получить регистрацию вебинара по идентификатору регистрации и использовать $expand для включения сеансов.
Запрос
Ниже показан пример запроса.
GET https://graph.microsoft.com/v1.0/solutions/virtualEvent/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21/registrations/127962bb-84e1-7b62-fd98-1c9d39def7b6?$expand=sessions
Отклик
Ниже показан пример отклика.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 200 OK
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",
"externalRegistrationInformation": {
"referrer": "Fabrikam",
"registrationId": "myExternalRegistrationId"
},
"status": "registered",
"registrationDateTime": "2025-01-07T22:04:17",
"cancelationDateTime": null,
"registrationQuestionAnswers": [
{
"questionId": "95320781-96b3-4b8f-8cf8-e6561d23447a",
"displayName": "Which city do you currently work in?",
"value": null,
"booleanValue": null,
"multiChoiceValues": [
"Seattle"
]
}
],
"sessions@odata.navigationLink": "/webinars/f4b39f1c-520e-4e75-805a-4b0f2016a0c6@a1a56d21/registrations/127962bb-84e1-7b62-fd98-1c9d39def7b6/sessions",
"sessions": [
{
"@odata.type": "#microsoft.graph.virtualEventSession",
"id": "8d62dd52-4dff-4c75-96a9-f905cc3ff942",
"startDateTime": "2025-01-08T12:30:00Z",
"endDateTime": "2025-01-09T22:00:00Z",
"videoOnDemandWebUrl": "https://df.events.teams.microsoft.com/webinars/webinarId/sessions/session1",
"joinWebUrl": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_ZDVjNzk3OWEtYjc2NS00NTA1LTkyMzQtYTYzMGI5YmFmMjM5%40thread.v2/0?context=%7b%22Tid%22%3a%2272f988bf-86f1-41af-91ab-2d7cd011db47%22%2c%22Oid%22%3a%221cd068e4-5b08-4e75-a7f9-7b4e067a0820%22%7d",
"subject": "Session one",
"participants": {
"@odata.type": "microsoft.graph.meetingParticipants"
},
"isBroadcast": null,
"broadcastSettings": null,
"capabilities": [],
"audioConferencing": null,
"chatInfo": {
"threadId": "19:meeting_ZDVjNzk3OWEtYjc2NS00NTA1LTkyMzQtYTYzMGI5YmFmMjM5@thread.v2",
"messageId": "0",
"replyChainMessageId": null
},
"videoTeleconferenceId": null,
"externalId": null,
"joinMeetingIdSettings": null,
"lobbyBypassSettings": null,
"isEntryExitAnnounced": null,
"allowedPresenters": null,
"allowAttendeeToEnableMic": null,
"allowAttendeeToEnableCamera": null,
"allowMeetingChat": null,
"shareMeetingChatHistoryDefault": null,
"allowTeamworkReactions": null,
"recordAutomatically": null,
"watermarkProtection": null,
"allowParticipantsToChangeName": null
}
]
}