Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Пространство имен: microsoft.graph
Обновите свойства указанного объекта onlineMeeting .
Список свойств, поддерживающих обновление, см. в разделе Текст запроса .
Примечание.
Если вы приглашаете на собрание список контактов из более чем 150 участников, они могут получить доступ к чату только во время собрания. Если некоторые пользователи в списке контактов являются обязательными участниками, а остальные являются необязательными, добавьте их непосредственно в качестве участников. Если вы добавите список контактов, в результате чего чат превышает 1000 человек, вы не сможете добавить список. Дополнительные сведения см. в разделе Чат в собраниях Microsoft Teams.
Этот API доступен в следующих национальных облачных развертываниях.
| Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
Разрешения
В следующих таблицах показаны минимальные разрешения или разрешения, необходимые для вызова этого API для каждого поддерживаемого типа ресурсов. Следуйте рекомендациям , чтобы запросить разрешения с наименьшими привилегиями. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
Разрешения для следующего HTTP-запроса:
PATCH /me/onlineMeetings/{meetingId}
| Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
|---|---|---|
| Делегированные (рабочая или учебная учетная запись) | OnlineMeetings.ReadWrite | Недоступно. |
| Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
| Для приложений | Не поддерживается. | Не поддерживается. |
Разрешения для следующего HTTP-запроса:
PATCH /users/{userId}/onlineMeetings/{meetingId}
| Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
|---|---|---|
| Делегированные (рабочая или учебная учетная запись) | OnlineMeetings.ReadWrite | Недоступно. |
| Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
| Для приложений | OnlineMeetings.ReadWrite.All | Недоступно. |
Примечание.
Чтобы использовать разрешение приложения для этого API, администраторы клиентов должны создать политику доступа к приложениям и предоставить ее пользователю, чтобы авторизовать приложение, настроенное в политике, для обновления собраний по сети от имени этого пользователя (с идентификатором пользователя, указанным в пути запроса).
HTTP-запрос
Чтобы обновить указанный onlineMeeting с помощью идентификатора собрания с делегированным разрешением (/me) и приложения (/users/{userId}/), выполните следующие действия:
PATCH /me/onlineMeetings/{meetingId}
PATCH /users/{userId}/onlineMeetings/{meetingId}
Примечание.
-
userId— это идентификатор объекта пользователя на странице управления пользователями Центр администрирования Microsoft Entra>. Дополнительные сведения см. в разделе Политика доступа к приложениям. -
meetingId— это идентификатор объекта onlineMeeting .
Заголовки запросов
| Имя | Описание |
|---|---|
| Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
| Content-Type | application/json. Обязательно. |
Текст запроса
В следующей таблице перечислены свойства, которые можно обновить. В тексте запроса укажите только значения свойств, которые следует обновить, за следующими исключениями:
- Для настройки даты и времени начала или окончания собрания по сети всегда требуются свойства startDateTime и endDateTime в тексте запроса.
- Не удается обновить поле организатора свойства участников . Организатор собрания не может быть изменен после создания собрания.
- Для настройки поля участников свойства участников , например добавления или удаления участника собрания, всегда требуется полный список участников в тексте запроса.
Последний столбец указывает, вступит ли в силу обновление этого свойства для текущего собрания.
| Свойство | Тип | Описание | Применяется к проводимым собраниям? |
|---|---|---|---|
| allowAttendeeToEnableCamera | Логический | Указывает, могут ли участники включить камеру. | Да |
| allowAttendeeToEnableMic | Логический | Указывает, могут ли участники включать микрофон. | Да |
| allowBreakoutRooms | Логический | Указывает, включены ли переговорные комнаты для собрания. | Нет |
| allowCopyingAndSharingMeetingContent | Логический | Указывает, включена ли возможность копирования и совместного использования содержимого собрания для собрания. | Да |
| allowedLobbyAdmitters | allowedLobbyAdmitterRoles | Указывает пользователей, которые могут принимать из лобби. Допустимые значения: organizerAndCoOrganizersAndPresenters, organizerAndCoOrganizers, unknownFutureValue. |
Да |
| allowedPresenters | onlineMeetingPresenters | Указывает, кто может быть выступающим на собрании. | Да |
| allowLiveShare | meetingLiveShareOptions | Указывает, включена ли трансляция для собрания. | Нет |
| allowMeetingChat | meetingChatMode | Указывает режим чата на собрании. | Да |
| allowPowerPointSharing | Логический | Указывает, включена ли трансляция в PowerPoint для собрания. | Нет |
| allowRecording | Логический | Указывает, включена ли запись для собрания. Наследуется от onlineMeetingBase. | Да |
| allowTeamworkReactions | Логический | Указывает, включены ли реакции Teams для собрания. | Да |
| allowTranscription | Логический | Указывает, включено ли транскрибирование для собрания. Наследуется от onlineMeetingBase. | Да |
| allowWhiteboard | Логический | Указывает, включена ли доска для собрания. | Нет |
| anonymizeIdentityForRoles | коллекция onlineMeetingRole | Указывает, чье удостоверение является анонимным в собрании. Возможные значения: attendee. После attendee добавления значение нельзя удалить с помощью операции PATCH. Наследуется от onlineMeetingBase. |
Нет |
| endDateTime | DateTime | Время окончания собрания в формате UTC. | Нет |
| isEndToEndEncryptionEnabled | Логический | Указывает, включено ли комплексное шифрование (E2EE) для собрания. | Нет |
| isEntryExitAnnounced | Логический | Следует ли объявлять о том, когда вызывающие присоединяются или покидают ее. | Да |
| lobbyBypassSettings | lobbyBypassSettings | Указывает, какие участники могут обходить вестибюль собрания. | Да |
| meetingSpokenLanguageTag | String | Указывает разговорный язык, используемый во время собрания для записи и транскрибирования. | Нет |
| participants | meetingParticipants | Участники, связанные с собранием по сети. Обновлять можно только участников. | Нет |
| recordAutomatically | Логический | Указывает, следует ли записывать собрание автоматически. | Нет |
| sensitivityLabelAssignment | onlineMeetingSensitivityLabelAssignment | Указывает метку конфиденциальности, применяемую к собранию Teams. | Нет |
| startDateTime | DateTime | Время начала собрания в формате UTC. | Нет |
| subject | String | Тема онлайн-собрания. | Нет |
| watermarkProtection | watermarkProtectionValues | Указывает, должно ли клиентское приложение применять водяной знак к типу контента. Наследуется от onlineMeetingBase. Наследуется от onlineMeetingBase. | Нет |
| broadcastSettings (не рекомендуется) | broadcastMeetingSettings | Параметры, связанные с трансляцией. | Нет |
Примечание.
- Список возможных значений для allowedPresenters, allowLiveShare и allowMeetingChat см. в разделе onlineMeeting.
- При обновлении значения allowedPresenters до
roleIsPresenterдобавьте в текст запроса полный список участников с заданной ролью участников, для которых задано значениеpresenter.
Отклик
В случае успешного 200 OK выполнения этот метод возвращает код ответа и обновленный объект onlineMeeting в теле отклика.
Примеры
Пример 1. Обновление startDateTime, endDateTime и subject
Запрос
Примечание: Идентификатор собрания сокращен для удобства чтения.
PATCH https://graph.microsoft.com/v1.0/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi
Content-Type: application/json
{
"startDateTime": "2020-09-09T14:33:30.8546353-07:00",
"endDateTime": "2020-09-09T15:03:30.8566356-07:00",
"subject": "Patch Meeting Subject",
"meetingSpokenLanguageTag": "en-US"
}
Отклик
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 200 OK
Content-Type: application/json
{
"id":"MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi",
"creationDateTime":"2020-07-03T00:23:39.444642Z",
"startDateTime":"2020-09-09T21:33:30.8546353Z",
"endDateTime":"2020-09-09T22:03:30.8566356Z",
"joinWebUrl":"url",
"subject":"Patch Meeting Subject",
"isBroadcast":false,
"autoAdmittedUsers":"EveryoneInCompany",
"participants":{
"organizer":{
"upn":"upn",
"role": "presenter",
"identity":{
"azureApplicationInstance":null,
"applicationInstance":null,
"application":null,
"device":null,
"user":{
"id":"8716745d-77a9-4be3-afff-009e4b81658e",
"displayName":null,
"tenantId":"0823831b-1f1b-424b-b90a-1caa345a742a",
"identityProvider":"AAD"
}
}
}
},
"sensitivityLabelAssignment": {
"sensitivityLabelId": "c7f2d7a7-6a36-4a41-9a6b-0d2761a9f4f0"
},
"meetingSpokenLanguageTag": "en-US",
"audioConferencing":{
"conferenceId":"id",
"tollNumber":"+1-900-555-0100",
"tollFreeNumber":"+1-800-555-0100",
"dialinUrl":"url"
}
}
Пример 2. Обновление объекта lobbyBypassSettings
Примечание: Идентификатор собрания сокращен для удобства чтения.
PATCH https://graph.microsoft.com/v1.0/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi
Content-Type: application/json
{
"lobbyBypassSettings": {
"isDialInBypassEnabled": true
}
}
Отклик
HTTP/1.1 200 OK
Content-Type: application/json
{
"id": "MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi",
"creationDateTime":"2020-07-03T00:23:39.444642Z",
"startDateTime":"2020-09-09T21:33:30.8546353Z",
"endDateTime":"2020-09-09T22:03:30.8566356Z",
"joinWebUrl":"(redacted)",
"subject":"Patch Meeting Subject",
"autoAdmittedUsers": "EveryoneInCompany",
"isEntryExitAnnounced": true,
"allowedPresenters": "everyone",
"videoTeleconferenceId": "(redacted)",
"participants": {
"organizer": {
"upn": "(redacted)",
"role": "presenter",
"identity": {
"user": {
"id": "dc17674c-81d9-4adb-bfb2-8f6a442e4622",
"displayName": null,
"tenantId": "909c6581-5130-43e9-88f3-fcb3582cde38",
"identityProvider": "AAD"
}
}
},
"attendees": [],
},
"sensitivityLabelAssignment": {
"sensitivityLabelId": "c7f2d7a7-6a36-4a41-9a6b-0d2761a9f4f0"
},
"meetingSpokenLanguageTag": "en-US",
"lobbyBypassSettings": {
"scope": "organization",
"isDialInBypassEnabled": true
}
}
Пример 3. Включение сквозного шифрования для существующего собрания по сети
В следующем примере показано, как включить сквозное шифрование для существующего собрания по сети.
Примечание: Свойство isEndToEndEncryptionEnabled должно использоваться с политиками Teams для определения окончательного поведения, а применение обновлений политики может занять до 24 часов. Дополнительные сведения см. в разделе Требование сквозного шифрования для конфиденциальных собраний Teams.
Запрос
Ниже показан пример запроса.
PATCH https://graph.microsoft.com/v1.0/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi
Content-Type: application/json
{
"isEndToEndEncryptionEnabled": true
}
Отклик
Ниже показан пример отклика.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 200 OK
Content-Type: application/json
{
"id": "MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi",
"creationDateTime": "2020-07-03T00:23:39.444642Z",
"startDateTime": "2020-09-09T21:33:30.8546353Z",
"endDateTime": "2020-09-09T22:03:30.8566356Z",
"joinWebUrl": "(redacted)",
"subject": "Patch Meeting Subject",
"autoAdmittedUsers": "EveryoneInCompany",
"isEndToEndEncryptionEnabled": true,
"isEntryExitAnnounced": true,
"allowedPresenters": "everyone",
"videoTeleconferenceId": "(redacted)",
"participants": {
"organizer": {
"upn": "(redacted)",
"role": "presenter",
"identity": {
"user": {
"id": "dc17674c-81d9-4adb-bfb2-8f6a442e4622",
"displayName": null,
"tenantId": "909c6581-5130-43e9-88f3-fcb3582cde38",
"identityProvider": "AAD"
}
}
},
"attendees": []
},
"sensitivityLabelAssignment": {
"sensitivityLabelId": "c7f2d7a7-6a36-4a41-9a6b-0d2761a9f4f0"
},
"meetingSpokenLanguageTag": "en-US",
"lobbyBypassSettings": {
"scope": "organization",
"isDialInBypassEnabled": true
}
}