Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Пространство имен: microsoft.graph
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Содержит сведения о собрании, включая URL-адрес, используемый для присоединения к собранию, список участников и описание.
Этот ресурс поддерживает подписку на уведомления об изменениях. Дополнительные сведения см. в статье Подписка на собрания по сети.
Наследует от onlineMeetingBase.
Предостережение
API-интерфейсы онлайн-собраний Microsoft Graph, поддерживающие трансляции Microsoft Teams, не рекомендуется возвращать данные 30 сентября 2024 г. Новые API Microsoft Graph заменят эти API весной 2025 г. Дополнительные сведения см. в статье Прекращение использования API трансляций Teams в Microsoft Graph.
Методы
| Метод | Возвращаемый тип | Описание |
|---|---|---|
| Создание | onlineMeeting | Создайте собрание по сети. |
| Получение | onlineMeeting | Чтение свойств и связей объекта onlineMeeting . |
| Обновление | onlineMeeting | Обновите свойства объекта onlineMeeting . |
| Delete | Нет | Удаление объекта onlineMeeting . |
| Создание или получение | onlineMeeting | Создайте собрание по сети с пользовательским внешним идентификатором. Если собрание уже существует, получите его свойства. |
| Перечисление записей | коллекция callRecording | Получите список объектов callRecording , связанных с onlineMeeting. |
| Перечисление расшифровок | Коллекция callTranscript | Получите список расшифровок объекта onlineMeeting. |
Примечание.
- Токен носителя требуется для заголовка
Authorizationдля всех методов, перечисленных в предыдущей таблице. Дополнительные сведения о том, как получитьtokenдля заголовкаAuthorization, см. в разделе Получение доступа от имени пользователя. - Срок действия собраний по сети устанавливается в 60 дней после начала или окончания собрания. Если собрание обновляется или активируется до истечения срока его действия, срок действия продлевается еще на 60 дней.
Свойства
| Свойство | Тип | Описание |
|---|---|---|
| allowAttendeeToEnableCamera | Логический | Указывает, могут ли участники включить камеру. Наследуется от onlineMeetingBase. |
| allowAttendeeToEnableMic | Логический | Указывает, могут ли участники включать микрофон. Наследуется от onlineMeetingBase. |
| allowBreakoutRooms | Логический | Указывает, включены ли переговорные комнаты для собрания. Наследуется от onlineMeetingBase. |
| allowCopyingAndSharingMeetingContent | Логический | Указывает, включено ли для собрания копирование содержимого собрания и предоставление общего доступа к ним. Наследуется от onlineMeetingBase. |
| allowedLobbyAdmitters | allowedLobbyAdmitterRoles | Указывает пользователей, которые могут принимать из лобби. Допустимые значения: organizerAndCoOrganizersAndPresenters, organizerAndCoOrganizers, unknownFutureValue. Наследуется от 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 | Задает параметры конфигурации для ограничений чата собраний. Наследуется от onlineMeetingBase. |
| creationDateTime | DateTime | Время создания собрания в формате UTC. Только для чтения. |
| endDateTime | DateTime | Время окончания собрания в формате UTC. Требуется при создании собрания по сети. |
| expiryDateTime | DateTimeOffset | Указывает дату и время истечения срока действия ресурса собрания. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. Наследуется от onlineMeetingBase. |
| externalId | String | Внешний идентификатор, который является пользовательским идентификатором. Необязательный параметр. |
| id | String | Идентификатор по умолчанию, связанный с собранием по сети. Только для чтения. Наследуется от onlineMeetingBase. |
| isEndToEndEncryptionEnabled | Логический | Указывает, включено ли комплексное шифрование (E2EE) для собрания по сети. Наследуется от onlineMeetingBase. |
| isEntryExitAnnounced | Логический | Указывает, следует ли объявлять, когда вызывающие присоединяются или покидают ее. Наследуется от onlineMeetingBase. |
| joinInformation | itemBody | Сведения о соединении в языке и варианте языкового стандарта, указанные в http-заголовке запроса Accept-Language. Только для чтения. Наследуется от onlineMeetingBase. |
| joinMeetingIdSettings | joinMeetingIdSettings | Указывает joinMeetingId, секретный код собрания и требование для секретного кода. После создания onlineMeetingпараметр joinMeetingIdSettings нельзя изменить. Чтобы внести какие-либо изменения в это свойство, собрание необходимо отменить и создать новое. Наследуется от onlineMeetingBase. |
| joinWebUrl | String | URL-адрес присоединения к собранию по сети. Формат URL-адреса может измениться; Поэтому пользователи не должны полагаться на какие-либо сведения, извлеченные из анализа URL-адреса. Только для чтения. Наследуется от onlineMeetingBase. |
| lobbyBypassSettings | lobbyBypassSettings | Указывает, какие участники могут обходить вестибюль собрания. Наследуется от onlineMeetingBase. |
| meetingOptionsWebUrl | String | Предоставляет URL-адрес страницы параметров собрания Teams для указанного собрания. Эта ссылка позволяет только организатору настраивать параметры собрания. Наследуется от onlineMeetingBase. |
| meetingSpokenLanguageTag | String | Указывает разговорный язык, используемый во время собрания для записи и транскрибирования. Наследуется от onlineMeetingBase. |
| meetingTemplateId | String | Идентификатор шаблона собрания. |
| participants | meetingParticipants | Участники, связанные с собранием по сети, включая организатора и участников. |
| recordAutomatically | Логический | Указывает, следует ли записывать собрание автоматически. Наследуется от onlineMeetingBase. |
| sensitivityLabelAssignment | onlineMeetingSensitivityLabelAssignment | Указывает метку конфиденциальности, применяемую к собранию Teams. |
| 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 .
Связи
| Связь | Тип | Описание |
|---|---|---|
| aiInsights | Коллекция callAiInsight | Аналитика ИИ, созданная для собрания по сети. Только для чтения. |
| посещаемостьОтчеты | коллекция meetingAttendanceReport | Отчеты о посещаемости собрания по сети. Только для чтения. Наследуется от onlineMeetingBase. |
| Записи | коллекция callRecording | Записи собрания по сети. Только для чтения. |
| Стенограммы | Коллекция callTranscript | Стенограммы собрания по сети. Только для чтения. |
| meetingAttendanceReport (не рекомендуется) | meetingAttendanceReport | Отчет о посещаемости последней онлайн-сессии собрания. Только для чтения. |
| регистрация (не рекомендуется) | meetingRegistration | Регистрация, включенная для собрания по сети. Для одного собрания по сети может быть включена только одна регистрация. |
Совет
- Свойство meetingAttendanceReport устарело. Он останется в бета-версии для обеспечения обратной совместимости. В дальнейшем используйте свойство attendanceReports для получения отчетов о посещаемости собрания по сети.
- Свойство registration устарело и перестанет возвращать данные 12 декабря 2024 г. Используйте новые API вебинара. Дополнительные сведения см. в разделе Прекращение использования бета-версий API регистрации собраний Microsoft Graph.
Представление JSON
В следующем представлении JSON показан тип ресурса.
{
"allowAttendeeToEnableCamera": "Boolean",
"allowAttendeeToEnableMic": "Boolean",
"allowBreakoutRooms": "Boolean",
"allowCopyingAndSharingMeetingContent": "Boolean",
"allowedLobbyAdmitters": "String",
"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"},
"chatRestrictions":{"@odata.type": "microsoft.graph.chatRestrictions"},
"creationDateTime": "String (timestamp)",
"endDateTime": "String (timestamp)",
"expiryDateTime": "String (timestamp)",
"externalId": "String",
"id": "String (identifier)",
"isEndToEndEncryptionEnabled": "Boolean",
"isEntryExitAnnounced": "Boolean",
"joinInformation": {"@odata.type": "microsoft.graph.itemBody"},
"joinMeetingIdSettings": {"@odata.type": "microsoft.graph.joinMeetingIdSettings"},
"joinWebUrl": "String",
"lobbyBypassSettings": {"@odata.type": "microsoft.graph.lobbyBypassSettings"},
"meetingOptionsWebUrl": "String",
"meetingSpokenLanguageTag": "String",
"meetingTemplateId": "String",
"sensitivityLabelAssignment": {
"@odata.type": "microsoft.graph.onlineMeetingSensitivityLabelAssignment"
},
"participants": {"@odata.type": "microsoft.graph.meetingParticipants"},
"recordAutomatically": "Boolean",
"shareMeetingChatHistoryDefault": "String",
"startDateTime": "String (timestamp)",
"subject": "String",
"videoTeleconferenceId": "String",
"watermarkProtection": {"@odata.type": "microsoft.graph.watermarkProtectionValues"}
}