Тип ресурса onlineMeeting
Пространство имен: microsoft.graph
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Содержит сведения о собрании, включая URL-адрес, используемый для присоединения к собранию, список участников и описание.
Этот ресурс поддерживает подписку на уведомления об изменениях. Дополнительные сведения см. в статье Подписка на собрания по сети.
Наследует от onlineMeetingBase.
Методы
| Метод | Возвращаемый тип | Описание |
|---|---|---|
| Создание | onlineMeeting | Создайте собрание по сети. |
| Получение | onlineMeeting | Чтение свойств и связей объекта onlineMeeting . |
| Обновление | onlineMeeting | Обновите свойства объекта onlineMeeting . |
| удаление; | Нет | Удаление объекта onlineMeeting . |
| Создание или получение | onlineMeeting | Создайте собрание по сети с пользовательским внешним идентификатором. Если собрание уже существует, получите его свойства. |
| Перечисление расшифровок | Коллекция callTranscript | Получите список расшифровок объекта onlineMeeting. |
| Перечисление записей | коллекция callRecording | Получите список объектов callRecording , связанных с onlineMeeting. |
Примечание.
Токен носителя требуется для заголовка Authorization для всех методов, перечисленных в предыдущей таблице. Дополнительные сведения о том, как получить token для заголовка Authorization , см. в разделе Получение доступа от имени пользователя.
Предостережение
API-интерфейсы собраний Graph Online, поддерживающие трансляцию Microsoft Teams, устарели и перестают работать 30 сентября 2024 г. Новые API Graph будут заменены весной 2024 г. Дополнительные сведения см. в статье Прекращение использования API трансляций Teams в Microsoft Graph.
Свойства
| Свойство | Тип | Описание |
|---|---|---|
| allowAttendeeToEnableCamera | Логический | Указывает, могут ли участники включить камеру. Наследуется от onlineMeetingBase. |
| allowAttendeeToEnableMic | Логический | Указывает, могут ли участники включать микрофон. Наследуется от onlineMeetingBase. |
| allowBreakoutRooms | Логический | Указывает, включены ли переговорные комнаты для собрания. Наследуется от onlineMeetingBase. |
| allowedPresenters | onlineMeetingPresenters | Указывает, кто может быть выступающим на собрании. Возможные значения: everyone, organization, roleIsPresenter, organizer, unknownFutureValue. Наследуется от onlineMeetingBase. |
| allowLiveShare | meetingLiveShareOptions | Указывает, включена ли трансляция для собрания. Возможные значения: enabled, disabled, unknownFutureValue. Наследуется от onlineMeetingBase. |
| allowMeetingChat | meetingChatMode | Указывает режим чата на собрании. Возможные значения: enabled, disabled, limited, unknownFutureValue. Наследуется от onlineMeetingBase. |
| allowParticipantsToChangeName | Логический | Указывает, разрешено ли участникам переименовать себя в экземпляре собрания. |
| allowPowerPointSharing | Логический | Указывает, включена ли трансляция в PowerPoint для собрания. Наследуется от onlineMeetingBase. |
| allowRecording | Логический | Указывает, включена ли запись для собрания. Наследуется от onlineMeetingBase. |
| allowTeamworkReactions | Логический | Указывает, включены ли реакции Teams для собрания. Наследуется от onlineMeetingBase. |
| allowTranscription | Логический | Указывает, включено ли транскрибирование для собрания. Наследуется от onlineMeetingBase. |
| allowWhiteboard | Логический | Указывает, включена ли доска для собрания. Наследуется от onlineMeetingBase. |
| anonymizeIdentityForRoles | коллекция onlineMeetingRole | Указывает, чье удостоверение является анонимным в собрании. Возможные значения: attendee. После attendee добавления значение нельзя удалить с помощью операции PATCH. Наследуется от onlineMeetingBase. |
| audioConferencing | audioConferencing | Сведения о доступе по телефону для собрания по сети. Только для чтения. Наследуется от onlineMeetingBase. |
| chatInfo | chatInfo | Сведения о чате, связанные с этим собранием по сети. Наследуется от onlineMeetingBase. |
| chatRestrictions | chatrestrictions | Задает конфигурацию для ограничений чата собраний. |
| creationDateTime | DateTime | Время создания собрания в формате UTC. Только для чтения. |
| endDateTime | DateTime | Время окончания собрания в формате UTC. Требуется при создании собрания по сети. |
| externalId | String | Внешний идентификатор. Настраиваемый идентификатор. Необязательный параметр. |
| id | String | Идентификатор по умолчанию, связанный с собранием по сети. Только для чтения. Наследуется от onlineMeetingBase. |
| isEntryExitAnnounced | Логический | Указывает, следует ли объявлять, когда вызывающие присоединяются или покидают ее. Наследуется от onlineMeetingBase. |
| joinInformation | itemBody | Сведения о соединении в языке и варианте языкового стандарта, указанные в http-заголовке запроса Accept-Language. Только для чтения. Наследуется от onlineMeetingBase. |
| joinMeetingIdSettings | joinMeetingIdSettings | Указывает joinMeetingId, секретный код собрания и требование для секретного кода. После создания onlineMeetingпараметр joinMeetingIdSettings нельзя изменить. Чтобы внести какие-либо изменения в это свойство, собрание необходимо отменить и создать новое. Наследуется от onlineMeetingBase. |
| joinWebUrl | String | URL-адрес присоединения к собранию по сети. Формат URL-адреса может измениться; Поэтому пользователи не должны полагаться на какие-либо сведения, извлеченные из анализа URL-адреса. Только для чтения. Наследуется от onlineMeetingBase. |
| lobbyBypassSettings | lobbyBypassSettings | Указывает, какие участники могут обходить вестибюль собрания. Наследуется от onlineMeetingBase. |
| meetingTemplateId | String | Идентификатор шаблона собрания. |
| participants | meetingParticipants | Участники, связанные с собранием по сети, включая организатора и участников. |
| recordAutomatically | Логический | Указывает, следует ли записывать собрание автоматически. Наследуется от onlineMeetingBase. |
| startDateTime | DateTime | Время начала собрания в формате UTC. Требуется при создании собрания по сети. |
| shareMeetingChatHistoryDefault | meetingChatHistoryDefaultMode | Указывает, предоставляется ли участникам общий доступ к журналу чата собрания. Возможные значения: all, none, unknownFutureValue. Наследуется от onlineMeetingBase. |
| subject | String | Тема онлайн-собрания. Наследуется от onlineMeetingBase. |
| videoTeleconferenceId | String | Идентификатор телеконференции видео. Только для чтения. Наследуется от onlineMeetingBase. |
| watermarkProtection | watermarkProtectionValues | Указывает, должно ли клиентское приложение применять водяной знак к типу контента. Наследуется от onlineMeetingBase. |
| alternativeRecording (не рекомендуется) | Поток | Поток содержимого альтернативной записи трансляции Microsoft Teams. Только для чтения. |
| attendeeReport (не рекомендуется) | Поток | Поток содержимого отчета участника трансляции Teams. Только для чтения. |
| autoAdmittedUsers (не рекомендуется) | String | Параметр, указывающий тип участников, которым автоматически разрешено участие в собрании по сети. Возможные значения: everyone, everyoneInSameAndFederatedCompany, everyoneInCompany, invitedUsersInCompany, organizer. Только для чтения. |
| broadcastSettings (не рекомендуется) | broadcastMeetingSettings | Параметры, связанные с трансляцией. |
| возможности (не рекомендуется) | коллекция meetingCapabilities | Список возможностей собраний. Возможные значения: questionAndAnswer,unknownFutureValue . |
| isBroadcast (не рекомендуется) | Логический | Указывает, является ли это событие трансляцией Teams. |
| запись (не рекомендуется) | Поток | Поток содержимого записи трансляции Teams. Только для чтения. |
Предостережение
- Свойство autoAdmittedUsers устарело. Вместо этого используйте свойство областьобъекта lobbyBypassSettings.
- Свойство capabilities устарело. Вместо этого используйте свойство isQuestionAndAnswerEnabledобъекта broadcastMeetingSettings .
значения meetingChatHistoryDefaultMode
| Значение | Описание |
|---|---|
| все | Все журналы чата собраний являются общими. |
| none | Журнал чата собрания не предоставляется. |
| unknownFutureValue | Изменяемое значение перечисления sentinel. Не используйте. |
значения meetingChatMode
| Значение | Описание |
|---|---|
| включено | Чат собрания включен. |
| отключено | Чат собрания отключен. |
| ограниченный | Чат собрания включен, но только во время вызова собрания. |
| unknownFutureValue | Изменяемое значение перечисления sentinel. Не используйте. |
значения meetingLiveShareOptions
| Значение | Описание |
|---|---|
| включено | Включен общий доступ к собранию. |
| отключено | Общий доступ к собранию отключен. |
| unknownFutureValue | Изменяемое значение перечисления sentinel. Не используйте. |
значения onlineMeetingPresenters
| Значение | Описание |
|---|---|
| каждый | Все выступающие. Значение, используемое по умолчанию. |
| organization; | Все в организации организатора являются выступающими. |
| roleIsPresenter | Выступающими являются только участники, роль которых является выступающим. |
| organizer | Выступающим является только организатор. |
| unknownFutureValue | Изменяемое значение перечисления sentinel. Не используйте. |
Совет
При создании или обновлении собрания по сети с параметром allowedPresenters в roleIsPresenterтекст запроса включите полный список участников с ролью указанных участников, для которых задано значение presenter .
Связи
| Связь | Тип | Описание |
|---|---|---|
| посещаемостьОтчеты | коллекция meetingAttendanceReport | Отчеты о посещаемости собрания по сети. Только для чтения. Наследуется от onlineMeetingBase. |
| Записи | коллекция callRecording | Записи собрания по сети. Только для чтения. |
| Стенограммы | Коллекция callTranscript | Стенограммы собрания по сети. Только для чтения. |
| meetingAttendanceReport (не рекомендуется) | meetingAttendanceReport | Отчет о посещаемости последней онлайн-сессии собрания. Только для чтения. |
| регистрация (не рекомендуется) | meetingRegistration | Регистрация, включенная для собрания по сети. Для одного собрания по сети может быть включена только одна регистрация. |
Совет
- Свойство meetingAttendanceReport устарело. Он останется в бета-версии для обеспечения обратной совместимости. В дальнейшем используйте свойство attendanceReports для получения отчетов о посещаемости собрания по сети.
- Свойство registration устарело и перестанет возвращать данные 12 декабря 2024 г. Используйте новые API вебинара. Дополнительные сведения см. в разделе Прекращение использования бета-версий API регистрации собраний Microsoft Graph.
Представление JSON
В следующем представлении JSON показан тип ресурса.
{
"allowAttendeeToEnableCamera": "Boolean",
"allowAttendeeToEnableMic": "Boolean",
"allowBreakoutRooms": "Boolean",
"allowedPresenters": "String",
"allowLiveShare": "String",
"allowMeetingChat": "String",
"allowParticipantsToChangeName": "Boolean",
"allowPowerPointSharing": "Boolean",
"allowRecording": "Boolean",
"allowTeamworkReactions": "Boolean",
"allowTranscription": "Boolean",
"allowWhiteboard": "Boolean",
"anonymizeIdentityForRoles": ["String"],
"audioConferencing": {"@odata.type": "microsoft.graph.audioConferencing"},
"chatInfo": {"@odata.type": "microsoft.graph.chatInfo"},
"creationDateTime": "String (timestamp)",
"endDateTime": "String (timestamp)",
"id": "String (identifier)",
"isEntryExitAnnounced": "Boolean",
"joinInformation": {"@odata.type": "microsoft.graph.itemBody"},
"joinMeetingIdSettings": {"@odata.type": "microsoft.graph.joinMeetingIdSettings"},
"joinWebUrl": "String",
"lobbyBypassSettings": {"@odata.type": "microsoft.graph.lobbyBypassSettings"},
"meetingTemplateId": "String",
"participants": {"@odata.type": "microsoft.graph.meetingParticipants"},
"recordAutomatically": "Boolean",
"shareMeetingChatHistoryDefault": "String",
"startDateTime": "String (timestamp)",
"subject": "String",
"videoTeleconferenceId": "String",
"watermarkProtection": {"@odata.type": "microsoft.graph.watermarkProtectionValues"}
}