Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Пространство имен: microsoft.graph
Обновите свойства объекта virtualEventTownhall .
Только организатор и соорганизатор могут вносить изменения в событие таунхолл.
Этот API доступен в следующих национальных облачных развертываниях.
| Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
| Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
|---|---|---|
| Делегированные (рабочая или учебная учетная запись) | VirtualEvent.ReadWrite | Недоступно. |
| Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
| Для приложений | Не поддерживается. | Не поддерживается. |
HTTP-запрос
PATCH /solutions/virtualEvents/townhalls/{id}
Заголовки запросов
| Имя | Описание |
|---|---|
| Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
| Content-Type | application/json. Обязательно. |
Текст запроса
В тексте запроса укажите только значения свойств для обновления. Существующие свойства, которые не включены в текст запроса, сохраняют свои предыдущие значения или пересчитываются на основе изменений других значений свойств.
В следующей таблице указаны свойства, которые можно обновить.
| Свойство | Тип | Описание |
|---|---|---|
| соорганизаторы | коллекция communicationsUserIdentity | Сведения об удостоверениях соорганизаторов виртуального события. |
| description | itemBody | Описание виртуального события. |
| displayName | String | Отображаемое имя виртуального события. |
| endDateTime | dateTimeTimeZone | Дата и время окончания виртуального события. |
| invitedAttendees | Коллекция удостоверений | Личности участников, приглашенных в ратушу. Поддерживаемые удостоверения: communicationsGuestIdentity и communicationsUserIdentity. |
| settings | virtualEventSettings | Параметры виртуального события. |
| startDateTime | dateTimeTimeZone | Дата и время начала виртуального события. |
Отклик
В случае успешного выполнения этот метод возвращает код отклика 200 OK и обновленный объект virtualEventTownhall в теле отклика.
Примеры
Запрос
Ниже показан пример запроса.
PATCH https://graph.microsoft.com/v1.0/solutions/virtualEvents/townhalls/fc6e8c15-2fd7-1dd5-caa0-87056e6a12be
Content-Type: application/json
{
"startDateTime": {
"dateTime": "2024-03-31T10:00:00",
"timeZone": "Pacific Standard Time"
},
"endDateTime": {
"dateTime": "2024-03-31T17:00:00",
"timeZone": "Pacific Standard Time"
}
}
Отклик
Ниже показан пример отклика.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.virtualEventTownhall",
"id": "a57082a9-7629-4f74-8da0-8d621aab4d2d@4aa05bcc-1cac-4a83-a9ae-0db84b88f4ba",
"status": "draft",
"displayName": "The Impact of Tech on Our Lives",
"description": {
"content": "<p>Discusses how technology has changed the way we communicate, work, and interact with each other.<p>",
"contentType": "html"
},
"startDateTime": {
"dateTime": "2024-03-31T10:00:00",
"timeZone": "Pacific Standard Time"
},
"endDateTime": {
"dateTime": "2024-03-31T17:00:00",
"timeZone": "Pacific Standard Time"
},
"createdBy": {
"application": null,
"device": null,
"user": {
"@odata.type": "#microsoft.graph.communicationsUserIdentity",
"id": "b7ef013a-c73c-4ec7-8ccb-e56290f45f68",
"displayName": "Diane Demoss",
"tenantId": "77229959-e479-4a73-b6e0-ddac27be315c"
}
},
"audience": "organization",
"isInviteOnly": false,
"coOrganizers": [
{
"id": "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b",
"displayName": "Kenneth Brown",
"tenantId": "77229959-e479-4a73-b6e0-ddac27be315c"
}
],
"invitedAttendees": [
{
"@odata.type": "microsoft.graph.communicationsUserIdentity",
"id": "127962bb-84e1-7b62-fd98-1c9d39def7b6",
"displayName": "Emilee Pham",
"tenantId": "77229959-e479-4a73-b6e0-ddac27be315c"
}
],
"settings": {
"isAttendeeEmailNotificationEnabled": false
},
"externalEventInformation": [
{
"applicationId" : "1b7ba4d1-c377-4b2f-ad0e-a3fc50bc987b",
"externalEventId": "myExternalEventId"
}
]
}