Descripción general de la API de REST de Google Meet

La API de REST de Google Meet te permite crear y administrar reuniones para 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 conferencia por nombre de recurso.
  • Obtén una lista de los participantes y las sesiones de los participantes.
  • Obtener los artefactos de la reunión (grabaciones, transcripciones y entradas de transcripción).

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 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 una sala de reuniones para adaptar la experiencia según sea necesario. También puedes administrar a los invitados y ajustar previamente la configuración.

  • Durante una conferencia: Recupera la información de la conferencia para cambiar la experiencia en la app según los metadatos que se muestran.

  • Después de una conferencia: Recupera artefactos de la conferencia, como la grabación y la transcripción.

Estos son algunos ejemplos de los casos en los que podrías usar la API de REST de Meet:

  • Administración de cuentas y ventas

    • Recupera la información de la reunión y de los participantes para su registro.
    • Obtener artefactos de reuniones y publicarlos en las cuentas
    • Ejecuta transcripciones y grabaciones con modelos de IA para generar asesoramiento y análisis de eficacia de ventas.

  • Aprendizaje y desarrollo

    • Crea y configura previamente reuniones para la capacitación.
    • Asigna roles de coorganizador a los capacitadores y líderes de sesión.
    • Recupera grabaciones que permitan a los estudiantes revisar los materiales una vez que finalice el curso.

  • Operaciones del desarrollador

    • Cree reuniones para conectar a sus compañeros de equipo al instante.
    • Permite que otras partes interesadas se unan a las reuniones en curso al compartir información sobre los participantes y las reuniones en tiempo real.
    • Ejecuta los datos de transcripción mediante modelos de IA para generar los próximos pasos correctos.
Crea reuniones dinámicas con tus colegas en un espacio de Chat y únete a ellas.
Figura 1: Crea reuniones dinámicas con tus colegas en un espacio de Chat y únete a ellas.

También puedes incorporar otras APIs de Google Workspace, como la API de Chat, en tu app para optimizar aún más la colaboración. Para obtener más información, consulta Casos de uso de Chat.

Términos comunes

A continuación, se incluye una lista de términos comunes que se usan en esta API:

Artefacto
Archivo generado por 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
Es un evento en el Calendario de Google con varios asistentes, por lo general, creado por un organizador de una reunión y que contiene la información para unirse a una reunión. Meet podría ser la solución de conferencia para el evento.
Llamar
Es una sesión en la que se usa Meet, o bien para notificar a otras personas que una llamada está comenzando o en curso y permitirles que se unan de inmediato.
Conferencia
Una conferencia es una instancia de una llamada dentro de una sala de reuniones. Por lo general, los usuarios consideran 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 de hosts, excepto la capacidad de quitar el host original.
Host
La persona que creó una llamada (el organizador de la reunión) o la persona que la controla. Ten en cuenta que el organizador puede organizar la reunión, pero no puede estar presente cuando esta tenga lugar. 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 puede escribirse para una sala de reuniones y que se usa en la URL de unión de una sala de reuniones. Por ejemplo, abc-mnop-xyz. Los códigos de reunión no deben almacenarse a largo plazo, ya que pueden desvincularse de un espacio 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 detalles, consulta Más 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. El ID de la reunión se muestra en el campo name de un recurso spaces.
Organizador de la reunión
El usuario que creó la sala de reuniones. También se puede considerar el propietario de la reunión. Es posible que no esté presente durante la llamada o que sea el organizador de la reunión. Solo puede haber un organizador.
Sala de reuniones
Es un lugar virtual o un objeto persistente (como una sala de reuniones) donde 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.
Participante
Una persona que se une a una llamada o que usa el Modo complementario, y que mira contenido como oyente o como 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 participantes
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 de participante y dispositivo, a cada uno se le asignarán 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 que los usuarios autoricen para que tu app acceda al contenido de la reunión. Cuando alguien instala tu app, se le pide que valide estos alcances. En general, debes elegir el alcance más específico posible y evitar solicitar permisos que tu app no requiere. Los usuarios otorgan acceso a permisos limitados y claramente descritos con mayor facilidad.

La API de REST de Meet admite los siguientes permisos de OAuth 2.0:

Código de 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 creadas por tu app. Sensible
https://www.googleapis.com/auth/drive.readonly Permite que las apps descarguen archivos de grabaciones y transcripciones de la API de Google Drive. Restringido

Para obtener más información sobre los permisos específicos de OAuth 2.0, consulta Permisos de OAuth 2.0 para las APIs de Google.