La API de REST de Google Meet te permite crear y administrar reuniones de Google Meet, y ofrece puntos de entrada a los usuarios directamente desde tu app.
Con la API de REST de Meet, puedes hacer lo siguiente:
- Crea una sala de reuniones para conectar a los usuarios por video.
- Obtén una sala de reuniones o una conferencia por nombre del recurso.
- Obtén una lista de los participantes y sus sesiones.
- Obtener artefactos de las reuniones (grabaciones, transcripciones y entradas de transcripciones)
También puedes suscribirte a eventos de Meet con la API de Google Workspace Events. Para recibir notificaciones sobre los cambios, puedes suscribirte a una sala de reuniones específica o a todas las salas de reuniones que pertenezcan a un usuario específico. Para obtener más información, consulta Suscríbete a eventos con la API de Google Workspace Events y Suscríbete a eventos de Google Meet.
Casos de uso
Las apps se pueden integrar con la API de REST de Meet para realizar las siguientes tareas:
Antes de una conferencia: Crea la sala de reuniones para adaptar la experiencia de la conferencia según sea necesario. También puedes administrar a los invitados y predefinir la configuración.
Durante una conferencia: Recupera información de conferencias para cambiar la experiencia de tu app en función de los metadatos que se muestran.
Después de una conferencia: Recupera artefactos de conferencia, como la grabación y la transcripción.
Estos son algunos ejemplos de lo que puedes hacer con la API de REST de Meet:
Administración de cuentas y ventas
- Recuperar la información de las reuniones y de los participantes para grabar
- Recupera artefactos de la reunión y publícalos en las cuentas.
- Ejecuta transcripciones y grabaciones a través de modelos de IA para generar análisis de efectividad de asesoramiento y ventas.
Aprendizaje y desarrollo
- Crear reuniones y configurarlas previamente para entrenamiento
- Asigna roles de coorganizador a los capacitadores y a los líderes de sesión.
- Recuperar grabaciones que les permitan a los estudiantes revisar los materiales una vez finalizado el curso
Operaciones de desarrollador
- Crea reuniones para conectar a tus compañeros de equipo al instante.
- Permitir que otros interesados se unan a las reuniones en curso compartiendo información en tiempo real de los participantes y de las reuniones.
- Ejecuta datos de transcripción a través de modelos de IA para generar los pasos siguientes correctos.
También puedes incorporar otras APIs de Google Workspace, como la API de Chat, a tu app para llevar aún más la colaboración. Para obtener más información, consulta Casos de uso de Chat.
Términos comunes
La siguiente es una lista de términos comunes usados en esta API:
- Artefacto
- Un archivo que genera Meet en respuesta a una conferencia, como grabaciones y transcripts. Por lo general, un artefacto está listo para recuperarse poco después de que finaliza una conferencia.
- Evento de calendario
- Un evento en el Calendario de Google con varios asistentes, generalmente creado por un organizador de la reunión, que contiene la información para unirse a una reunión. Meet podría ser la solución de conferencias para el evento.
- Llamar
- Una sesión a través de Meet o para notificar a otras personas que una llamada está comenzando o en curso y permitirles unirse de inmediato.
- Conferencia
- Una conferencia es una instancia de una llamada en una sala de reuniones. Los usuarios suelen considerar esta situación como una sola reunión.
- Co-host
- Una persona en una llamada a la que un host le otorgó privilegios de administración del host, excepto la capacidad de quitar el host original.
- Host
- La persona que creó la llamada (el organizador de la reunión) o la persona que controla la llamada Ten en cuenta que el organizador puede organizarla, pero no estar presente en el momento en que se lleve a cabo. Un host también puede delegar privilegios de host a un coorganizador.
- Código de reunión
Es una cadena única de 10 caracteres que se puede escribir para una sala de reuniones y que se usa dentro del URI de reunión de una sala de reuniones. No distingue mayúsculas de minúsculas. Por ejemplo,
abc-mnop-xyz
. La longitud máxima es de 128 caracteres.Los códigos de reunión no deben almacenarse a largo plazo, ya que se pueden desvincular de una sala de reuniones y se pueden volver a usar en diferentes salas de reuniones en el futuro. Por lo general, los códigos de reunión vencen 365 días después del último uso. Para obtener más información, consulta Información sobre los códigos de reunión en Google Meet.
- Nombre de la reunión
Es un ID único generado por el servidor que se usa para identificar una sala de reuniones. Distingue mayúsculas de minúsculas. Por ejemplo,
jQCFfuBOdN5z
El ID de reunión se muestra en el camponame
de un recursospaces
.- Organizador de la reunión
El usuario que creó la sala de reuniones Este usuario también puede considerarse el propietario de la reunión. Es posible que no esté presente durante la llamada o que no sea el organizador de la reunión. Solo puede haber un organizador de la reunión.
- Sala de reuniones
Es un lugar virtual o un objeto persistente (como una sala de reuniones) en el que se realiza una conferencia. Solo se puede realizar una conferencia activa en un espacio a la vez. Una sala de reuniones también ayuda a los usuarios a reunirse y encontrar recursos compartidos.
- URI de la reunión
Una URL en la que se puede hacer clic y que inicia una llamada o une a un usuario con ella. Cada llamada tiene una URL única que consta de
https://meet.google.com/
seguida del código de reunión. Por ejemplo,https://meet.google.com/abc-mnop-xyz
.- Participante
Una persona que se unió a una llamada o que usa el Modo complementario mirando contenido como un usuario o un dispositivo de la sala conectado a una llamada Hay un recurso
conferenceRecords.participants
para cada persona. Cuando un participante se une a la conferencia, se asigna un ID único.- Sesión de participante
Es un ID de sesión único creado para cada par participante y dispositivo que se une a una llamada. Hay un recurso
conferenceRecords.participants.participantSessions
para cada sesión. Si el participante se une a la misma llamada varias veces desde el mismo par participante y dispositivo, a cada uno se le asignan IDs de sesión únicos.
Información de autorización y autenticación específica de la API
Los permisos de autorización son aquellos que solicitas a los usuarios que autoricen para que tu app acceda al contenido de la reunión. Cuando alguien instala tu app, se le pide que valide estos permisos. Por lo general, debes elegir el alcance más específico posible y evitar solicitar permisos que tu app no requiere. Los usuarios otorgan acceso con mayor facilidad a alcances limitados y claramente descritos.
La API de REST de Meet admite los siguientes permisos de OAuth 2.0:
Código del permiso | Descripción | Uso |
---|---|---|
https://www.googleapis.com/auth/meetings.space.readonly |
Permite que las apps lean metadatos sobre cualquier sala de reuniones a la que tenga acceso el usuario. | Sensible |
https://www.googleapis.com/auth/meetings.space.created |
Permite que las apps creen, modifiquen y lean metadatos sobre salas de reuniones que creó tu app. | Sensible |
https://www.googleapis.com/auth/drive.readonly |
Permite que las apps descarguen archivos de grabación y transcripción desde la API de Google Drive. | Restringido |
Para obtener más información sobre los alcances específicos de OAuth 2.0, consulta Alcances de OAuth 2.0 para las APIs de Google.
Temas relacionados
Para obtener información sobre el desarrollo con las APIs de Google Workspace, incluido el manejo de la autenticación y la autorización, consulta Desarrolla en Google Workspace.
Para aprender a crear una sala de reuniones con la API de REST de Meet, lee la guía Trabaja con salas de reuniones.
Si quieres obtener más información para suscribirte a eventos de Google Workspace, consulta Suscríbete a eventos con la API de Google Workspace Events.