Create virtualEventTownhall
Пространство имен: microsoft.graph
Важно!
API версии /beta
в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Create новый объект virtualEventTownhall в режиме черновика.
Разрешения
Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.
Тип разрешения | Разрешение с наименьшими привилегиями | Более высокие привилегированные разрешения |
---|---|---|
Делегированные (рабочая или учебная учетная запись) | VirtualEvent.ReadWrite | Недоступно. |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
Для приложений | Не поддерживается. | Не поддерживается. |
HTTP-запрос
POST /solutions/virtualEvents/townhalls
Заголовки запросов
Имя | Описание |
---|---|
Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Content-Type | application/json. Обязательно. |
Текст запроса
В тексте запроса укажите представление в формате JSON поддерживаемых производных типов объекта virtualEventTownhall .
При создании virtualEventTownhall можно указать следующие свойства.
Свойство | Тип | Описание |
---|---|---|
Аудитории | meetingAudience | Аудитория, которой видна ратуша. |
соорганизаторы | коллекция communicationsUserIdentity | Сведения об идентификации соорганизаторов ратуши. |
description | itemBody | Описание ратуши. |
displayName | String | Отображаемое название ратуши. |
endDateTime | dateTimeTimeZone | Дата и время окончания ратуши. |
invitedAttendees | Коллекция удостоверений | Личности участников, приглашенных в ратушу. Поддерживаемые удостоверения: communicationsGuestIdentity и communicationsUserIdentity. |
isInviteOnly | Логический | Указывает, открыта ли ратуша только для приглашенных людей и групп в вашей организации. Свойство isInviteOnly может быть true только в том случае, если для свойства audience задано значение organization . |
startDateTime | dateTimeTimeZone | Дата и время начала работы ратуши. |
Отклик
В случае успешного выполнения этот метод возвращает код отклика 201 Created
и объект virtualEventTownhall в теле отклика.
Примеры
Запрос
Ниже показан пример запроса.
POST https://graph.microsoft.com/beta/solutions/virtualEvents/townhalls
Content-Type: application/json
{
"displayName": "The Impact of Tech on Our Lives",
"description": "Discusses how technology has changed the way we communicate.",
"startDateTime": {
"dateTime": "2023-03-30T10:00:00",
"timeZone": "Pacific Standard Time"
},
"endDateTime": {
"dateTime": "2023-03-30T17:00:00",
"timeZone": "Pacific Standard Time"
},
"audience": "organization",
"coOrganizers": [
{
"id": "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b",
"tenantId": "77229959-e479-4a73-b6e0-ddac27be315c"
}
]
}
Отклик
Ниже показан пример отклика.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 201 Created
Content-Type: application/json
{
"id": "bce9a3ca-a310-48fa-baf3-1cedcd04bb3f@4aa05bcc-1cac-4a83-a9ae-0db84b88f4ba",
"status": "draft",
"displayName": "The Impact of Tech on Our Lives",
"description": "Discusses how technology has changed the way we communicate.",
"startDateTime": {
"dateTime": "2023-03-30T10:00:00",
"timeZone": "Pacific Standard Time"
},
"endDateTime": {
"dateTime": "2023-03-30T17:00:00",
"timeZone": "Pacific Standard Time"
},
"audience": "organization",
"createdBy": {
"application": null,
"device": null,
"user": {
"id": "b7ef013a-c73c-4ec7-8ccb-e56290f45f68",
"displayName": "Diane Demoss",
"tenantId": "77229959-e479-4a73-b6e0-ddac27be315c"
}
},
"coOrganizers": [
{
"id": "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b",
"displayName": "Kenneth Brown",
"tenantId": "77229959-e479-4a73-b6e0-ddac27be315c"
}
],
"invitedAttendees": [],
"isInviteOnly": false
}
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по