Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Contiene información sobre una reunión, incluida la dirección URL usada para unirse a una reunión, la lista de asistentes y la descripción.
Este recurso admite la suscripción a notificaciones de cambios. Para obtener más información, consulte Suscribirse a reuniones en línea.
Hereda de onlineMeetingBase.
Precaución
Las API de reuniones en línea de Microsoft Graph que admiten eventos en directo de Microsoft Teams quedaron en desuso y dejaron de devolver datos el 30 de septiembre de 2024. Las nuevas API de Microsoft Graph reemplazarán a estas API en la primavera de 2025. Para obtener más información, consulte Retirada de la API de eventos en directo de Teams en Microsoft Graph.
Métodos
| Método | Tipo de valor devuelto | Descripción |
|---|---|---|
| Crear | onlineMeeting | Cree una reunión en línea. |
| Get | onlineMeeting | Leer las propiedades y relaciones de un objeto onlineMeeting . |
| Actualizar | onlineMeeting | Actualizar las propiedades de un objeto onlineMeeting . |
| Delete | Ninguno | Eliminar un objeto de onlineMeeting . |
| Crear u obtener | onlineMeeting | Cree una reunión en línea con un identificador externo personalizado. Si la reunión ya existe, recupere sus propiedades. |
| Enumerar grabaciones | Colección callRecording | Recuperar la lista de objetos callRecording asociados a un onlineMeeting. |
| Enumerar transcripciones | Colección callTranscript | Recuperar la lista de transcripciones de una reunión en línea. |
Nota:
- Se requiere un token de portador para el
Authorizationencabezado de todos los métodos enumerados en la tabla anterior. Para obtener más información sobre cómo obtener eltokenAuthorizationencabezado, consulte Obtener acceso en nombre de un usuario. - El tiempo de expiración de las reuniones en línea se establece en 60 días después de la hora de inicio o finalización de la reunión. Si la reunión se actualiza o activa antes de que expire, el tiempo de expiración se extiende otros 60 días.
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| allowAttendeeToEnableCamera | Booleano | Indica si los asistentes pueden activar la cámara. Heredado de onlineMeetingBase. |
| allowAttendeeToEnableMic | Booleano | Indica si los asistentes pueden activar su micrófono. Heredado de onlineMeetingBase. |
| allowBreakoutRooms | Booleano | Indica si las salas para sesión de subgrupo están habilitadas para la reunión. Heredado de onlineMeetingBase. |
| allowCopyingAndSharingMeetingContent | Booleano | Indica si está habilitado para la reunión la copia y el uso compartido del contenido de la reunión. Heredado de onlineMeetingBase. |
| allowedLobbyAdmitters | allowedLobbyAdmitterRoles | Especifica los usuarios que pueden admitir desde la sala de espera. Los valores posibles son: organizerAndCoOrganizersAndPresenters, organizerAndCoOrganizers, unknownFutureValue. Heredado de onlineMeetingBase. |
| allowedPresenters | onlineMeetingPresenters | Especifica quién puede ser moderador en una reunión. Los valores posibles son: everyone, organization, roleIsPresenter, organizer, unknownFutureValue. Heredado de onlineMeetingBase. |
| allowLiveShare | meetingLiveShareOptions | Indica si el recurso compartido en directo está habilitado para la reunión. Los valores posibles son: enabled, disabled, unknownFutureValue. Heredado de onlineMeetingBase. |
| allowMeetingChat | meetingChatMode | Especifica el modo de chat de reunión. Los valores posibles son: enabled, disabled, limited y unknownFutureValue Heredado de onlineMeetingBase. |
| allowParticipantsToChangeName | Booleano | Especifica si los participantes pueden cambiar su nombre en una instancia de la reunión. |
| allowPowerPointSharing | Booleano | Indica si PowerPoint Live está habilitado para la reunión. Heredado de onlineMeetingBase. |
| allowRecording | Booleano | Indica si está habilitada la grabación para la reunión. Heredado de onlineMeetingBase. |
| allowTeamworkReactions | Booleano | Indica si las reacciones de Teams están habilitadas para la reunión. Heredado de onlineMeetingBase. |
| allowTranscription | Booleano | Indica si la transcripción está habilitada para la reunión. Heredado de onlineMeetingBase. |
| allowWhiteboard | Booleano | Indica si Whiteboard está habilitado para la reunión. Heredado de onlineMeetingBase. |
| anonymizeIdentityForRoles | colección onlineMeetingRole | Especifica la identidad de quién se anonimiza en la reunión. Los valores posibles son: attendee. El attendee valor no se puede quitar a través de una operación PATCH una vez agregado. Heredado de onlineMeetingBase. |
| audioConferencia | audioConferencia | La información de acceso telefónico (acceso telefónico) para una reunión en línea. Solo lectura. Heredado de onlineMeetingBase. |
| chatInfo | chatInfo | La información del chat asociada a esta reunión en línea. Heredado de onlineMeetingBase. |
| chatRestrictions | chatRestrictions | Especifica las opciones de configuración para las restricciones de chat de reunión. Heredado de onlineMeetingBase. |
| cloudVideoInteropInfo | cloudVideoInteropInfo | Configuración de integración de dispositivos de conferencia para la interoperabilidad de vídeo en la nube (CVI). Solo lectura. Heredado de onlineMeetingBase. |
| creationDateTime | DateTime | La hora de creación de la reunión en UTC. Solo lectura. |
| endDateTime | DateTime | La hora de finalización de la reunión en UTC. Necesario al crear una reunión en línea. |
| expiryDateTime | DateTimeOffset | Indica la fecha y hora en que expira el recurso de reunión. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. Heredado de onlineMeetingBase. |
| externalId | Cadena | El identificador externo que es un identificador personalizado. Opcional. |
| id | Cadena | El identificador predeterminado asociado a la reunión en línea. Solo lectura. Heredado de onlineMeetingBase. |
| isEndToEndEncryptionEnabled | Booleano | Indica si el cifrado de un extremo a otro (E2EE) está habilitado para la reunión en línea. Heredado de onlineMeetingBase. |
| isEntryExitAnnounced | Booleano | Indica si se anuncia cuando los autores de llamadas se unen o abandonan. Heredado de onlineMeetingBase. |
| joinInformation | itemBody | La información de combinación en la variante de idioma y configuración regional especificada en el encabezado HTTP de la solicitud 'Accept-Language'. Solo lectura. Heredado de onlineMeetingBase. |
| joinMeetingIdSettings | joinMeetingIdSettings | Especifica joinMeetingId, el código de acceso de la reunión y el requisito para el código de acceso. Una vez que se crea una reunión en línea , joinMeetingIdSettings no se puede modificar. Para realizar cambios en esta propiedad, es necesario cancelar la reunión y crear una nueva. Heredado de onlineMeetingBase. |
| joinWebUrl | Cadena | La dirección URL para unirse de la reunión en línea. El formato de la dirección URL puede cambiar; por lo tanto, los usuarios no deben confiar en ninguna información extraída del análisis de la dirección URL. Solo lectura. Heredado de onlineMeetingBase. |
| lobbyBypassSettings | lobbyBypassSettings | Especifica qué participantes pueden omitir la sala de espera de la reunión. Heredado de onlineMeetingBase. |
| meetingOptionsWebUrl | Cadena | Proporciona la dirección URL de la página de opciones de reunión de Teams para la reunión especificada. Este vínculo permite que solo el organizador configure las opciones de la reunión. Heredado de onlineMeetingBase. |
| meetingSpokenLanguageTag | Cadena | Especifica el idioma hablado que se usa durante la reunión con fines de grabación y transcripción. Heredado de onlineMeetingBase. |
| meetingTemplateId | Cadena | El identificador de la plantilla de reunión. |
| meetingType | onlineMeetingType | El tipo de reunión en línea. Los valores posibles son: adhoc, scheduled, recurring, broadcast, meetnow, unknownFutureValue. Solo lectura. Heredado de onlineMeetingBase. |
| participants | meetingParticipants | Los participantes asociados a la reunión en línea, incluidos el organizador y los asistentes. |
| recordAutomatically | Booleano | Indica si se debe grabar la reunión automáticamente. Heredado de onlineMeetingBase. |
| sensitivityLabelAssignment | onlineMeetingSensitivityLabelAssignment | Especifica la etiqueta de confidencialidad que se aplica a la reunión de Teams. Heredado de onlineMeetingBase. |
| startDateTime | DateTime | La hora de inicio de la reunión en UTC. Necesario al crear una reunión en línea. |
| shareMeetingChatHistoryDefault | meetingChatHistoryDefaultMode | Especifica si el historial de chat de reuniones se comparte con los participantes. Los valores posibles son: all, none, unknownFutureValue. Heredado de onlineMeetingBase. |
| subject | Cadena | El tema de la reunión en línea. Heredado de onlineMeetingBase. |
| videoTeleconferenceId | Cadena | El identificador de teleconferencia de vídeo. Solo lectura. Heredado de onlineMeetingBase. |
| marca de aguaProtección | watermarkProtectionValues | Especifica si la aplicación cliente debe aplicar una marca de agua a un tipo de contenido. Heredado de onlineMeetingBase. |
| alternativeRecording (obsoleto) | Stream | Secuencia de contenido de la grabación alternativa de un evento en directo de Microsoft Teams. Solo lectura. |
| attendeeReport (obsoleto) | Stream | Flujo de contenido del informe de asistentes de un evento en directo de Teams. Solo lectura. |
| autoAdmittedUsers (en desuso) | Cadena | La configuración que especifica el tipo de participantes que se permiten automáticamente en la reunión en línea. Los valores posibles son: everyone, everyoneInSameAndFederatedCompany, everyoneInCompany, invitedUsersInCompany, organizer. Solo lectura. |
| broadcastSettings (obsoleto) | broadcastMeetingSettings | Configuración relacionada con un evento en directo. |
| Funcionalidades (en desuso) | meetingCapabilities collection | La lista de funcionalidades de la reunión. Los valores posibles son: questionAndAnswer,unknownFutureValue. |
| isBroadcast (obsoleto) | Booleano | Indica si se trata de un evento en directo de Teams. |
| Grabación (en desuso) | Stream | Secuencia de contenido de la grabación de un evento en directo de Teams. Solo lectura. |
Precaución
- La propiedad autoAdmittedUsers está obsoleta. En su lugar, use la propiedad de ámbito de lobbyBypassSettings .
- La propiedad capabilities está en desuso. En su lugar, use la propiedad isQuestionAndAnswerEnabled de broadcastMeetingSettings .
Valores de meetingChatHistoryDefaultMode
| Valor | Descripción |
|---|---|
| todo | Se comparte todo el historial de chat de reuniones. |
| ninguno | No se comparte ningún historial de chat de reunión. |
| unknownFutureValue | Valor centinela de enumeración evolutiva. No usar. |
valores meetingChatMode
| Valor | Descripción |
|---|---|
| habilitado | El chat de reunión está habilitado. |
| deshabilitado | El chat de reunión está deshabilitado. |
| de acceso | El chat de reunión está habilitado, pero solo durante la llamada de reunión. |
| unknownFutureValue | Valor centinela de enumeración evolutiva. No usar. |
valores de meetingLiveShareOptions
| Valor | Descripción |
|---|---|
| habilitado | El recurso compartido en directo de reuniones está habilitado. |
| deshabilitado | El recurso compartido en directo de reuniones está deshabilitado. |
| unknownFutureValue | Valor centinela de enumeración evolutiva. No usar. |
valores de onlineMeetingPresenters
| Valor | Descripción |
|---|---|
| Todo el mundo | Todo el mundo es un moderador. Valor predeterminado. |
| organización | Todos los miembros de la organización del organizador son moderadores. |
| roleIsPresenter | Solo los participantes cuyo rol es moderador son moderadores. |
| organizer | Solo el organizador es un moderador. |
| unknownFutureValue | Valor centinela de enumeración evolutiva. No usar. |
Sugerencia
Al crear o actualizar una reunión en línea con allowedPresenters establecido en roleIsPresenter, incluya una lista completa de asistentes con el rol de asistentes especificado establecido presenter en el cuerpo de la solicitud.
Relaciones
| Relación | Tipo | Descripción |
|---|---|---|
| aiInsights | Colección callAiInsight | La información de IA generada para una reunión en línea. Solo lectura. |
| attendanceReports | Recopilación meetingAttendanceReport | Los informes de asistencia de una reunión en línea. Solo lectura. Heredado de onlineMeetingBase. |
| grabaciones | Colección callRecording | Las grabaciones de una reunión en línea. Solo lectura. |
| Transcripciones | Colección callTranscript | Las transcripciones de una reunión en línea. Solo lectura. |
| meetingAttendanceReport (en desuso) | meetingAttendanceReport | Informe de asistencia de la última sesión de reunión en línea. Solo lectura. |
| Registro (en desuso) | meetingRegistration | El registro que está habilitado para una reunión en línea. Una reunión en línea solo puede tener un registro habilitado. |
Sugerencia
- La propiedad meetingAttendanceReport está obsoleta. Permanecerá en versión beta por motivos de compatibilidad con versiones anteriores. De ahora en adelante, use la propiedad attendanceReports para recuperar los informes de asistencia de una reunión en línea.
- La propiedad de registro está en desuso y dejará de devolver datos el 12 de diciembre de 2024. Utilice las nuevas API del seminario web. Para obtener más información, consulte Obsolescencia de las API beta de registro de reuniones de Microsoft Graph.
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"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"},
"cloudVideoInteropInfo": {"@odata.type": "microsoft.graph.cloudVideoInteropInfo"},
"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",
"meetingType": "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"}
}