Elegir una API en Microsoft Graph para crear y unirse a reuniones en línea

Microsoft Graph ofrece dos conjuntos de API que organizan y se unen a reuniones en línea en Microsoft Teams o Skype:

• API de calendario: utilice el recurso event.
• API de comunicaciones en la nube: use el recurso onlineMeeting.

La elección se encuentra entre:

• Un método práctico para configurar una reunión en línea en el calendario de Outlook en el que los asistentes hacen clic para unirse a la reunión y continuar su experiencia en Teams o en Skype.
• Y una integración más completa de características de Skype o Teams en una aplicación para una experiencia más personalizada.

Consideraciones al elegir una API para su escenario

Elija la API de calendario para una integración simplificada con el calendario de Outlook, que da como resultado un evento de reunión en línea en el calendario de Outlook:

• Soporte programático:
  • Las aplicaciones pueden crear o actualizar directamente un evento como una reunión en línea en el calendario de Outlook, con un blob join-Teams-meeting insertado en el evento del calendario de Outlook.
  • Las aplicaciones obtienen propiedades para unirse a la reunión a través de Internet o marcando.
• La experiencia de la interfaz de usuario de los asistentes con el evento de calendario creado mediante programación está en paridad completa con cualquier evento creado mediante la interfaz de usuario de Outlook:
  • Los asistentes pueden elegir reunirse en línea o en persona.
  • Los asistentes pueden hacer clic en el blob join-Teams-meeting para unirse a la reunión a través de Internet o marcado.
  • Los asistentes pueden usar otras características enriquecidas de Teams, como videoconferencia y sala de espera, si se configura.

Nota:

Nota: La integración con el calendario de Outlook supone que un administrador ha configurado Outlook para reuniones en línea. Compruebe la compatibilidad antes de usar la API.

Elija la API de comunicaciones en la nube para obtener flexibilidad y un soporte programático más amplio:

• Las aplicaciones tienen más flexibilidad para integrar más los resultados de la API con la línea de negocios y otras aplicaciones. La API se desacopla con un calendario específico y no crea un evento en ningún calendario.
• Las aplicaciones pueden proporcionar las siguientes funciones para los asistentes:
  • Información de unión basada en la configuración regional.
  • Unirse a la reunión a través de Internet o marcando.
  • Vídeoconferencia.
  • Características de seguridad adicionales, como la sala de espera y la automatización de la admisión de asistentes (vista previa).
  • Asociar una reunión con un chat de Microsoft Teams.

Comparar las API

La siguiente tabla describe las diferencias en el nivel de la API.

Característica de reunión en línea	API de calendario (recurso event)	API de comunicaciones en la nube (recurso onlineMeeting)
Miembros de la API principal	Recurso event: - Propiedad isOnlineMeeting - Propiedad onlineMeeting del tipo onlineMeetingInfo - Propiedad onlineMeetingProvider Recurso calendar: - Propiedad allowedOnlineMeetingProviders - Propiedad defaultOnlineMeetingProvider	RecursoonlineMeeting Recurso audioConferencing
Integración con un elemento de calendario	- Crear o actualizarla API de eventos establece automáticamente el evento de calendario de Outlook resultante como una reunión en línea. - Use las propiedades isOnlineMeeting, onlineMeeting y onlineMeetingProvider del evento del calendario de Outlook devuelto.	- Crear API devuelve un recurso onlineMeeting que es independiente de un tipo de calendario determinado. - No crea ni actualiza ningún evento de Outlook. - Integre la información de recurso de OnlineMeeting devuelta en una experiencia de aplicación adecuada para su escenario. - Use createOrGet para devolver una reunión en línea que tiene un valor de externalId específico, o cree uno si todavía no existe ninguno, para simplificar la incrustación de la reunión resultante en un calendario de terceros.
Cambiar a una reunión sin conexión	- No: una vez que habilita un evento para unirse en línea, no puede actualizarlo para convertirlo en una reunión fuera de línea. - No se puede cambiar la propiedad onlineMeetingProvider, ni establecer isOnlineMeeting en false para deshabilitar la reunión en línea.	No: una vez que crea un recurso onlineMeeting, solo puede eliminarlo, pero no puede cambiarlo a una reunión sin conexión.
Información de unión basada en la configuración regional	Sin integración directa de API.	- Use el encabezado HTTP Accept-Language cuando cree una reunión en línea. - Vea el ejemplo.
Unirse a través de Internet (VoIP)	A través de la propiedad onlineMeeting, acceda a joinUrl.	Use la propiedad joinWebUrl.
Unirse mediante acceso telefónico	A través de la propiedad onlineMeeting, acceda: - conferenceId, quickDial, phones, tollFreeNumbers, tollNumber.	A través de la propiedad audioConferencing, acceda: - conferenceId, tollFreeNumber, tollNumber. - Propiedad dialinUrl para una página web accesible externamente que contiene información de acceso telefónico para facilitar la integración con aplicaciones de terceros.
Unirse por videoconferencia (audio y video)	Sin integración directa de API.	Use la propiedad videoTeleconferenceId.
Sala de espera y admisión automática de asistentes a la reunión en línea	- Sin integración directa con la API. - En el blob join-Teams-meeting del evento, los asistentes pueden hacer clic en el vínculo Opciones de reunión para acceder a la sala de espera de la reunión, si el administrador lo habilita.	- La API diferencia a los asistentes de la empresa organizadora y las empresas federadas, y otros asistentes, incluidos los anónimos. - Utilice la propiedad lobbyBypassSettings .
Relacionado con un chat de Teams	Sin integración directa de API.	Use la propiedad chatInfo.