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

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 un espacio de reunión para conectar a los usuarios por video.
  • Obtén un espacio de reunión o una conferencia por nombre de 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 un espacio de reunión específico o a todos los espacios de reunión que pertenezcan a un usuario específico. Para obtener más información, consulta Cómo suscribirse a eventos con la API de Google Workspace Events y Cómo suscribirse a eventos de Google Meet.

Casos de uso

Las apps pueden integrarse en la API de REST de Meet para realizar las siguientes tareas:

  • Antes de una conferencia: Crea el espacio de reunión para adaptar la experiencia según sea necesario. También puedes administrar a los invitados y preconfigurar la configuración.

  • Durante una conferencia: Recupera información de la conferencia para cambiar la experiencia de tu 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 situaciones en las que podrías usar la API de REST de Meet:

  • Ventas y administración de cuentas

    • Recuperar información de la reunión y de los participantes para fines de registro
    • Recupera artefactos de reuniones y publícalos en las cuentas.
    • Ejecuta transcripciones y grabaciones a través de modelos de IA para generar análisis de eficacia de coaching y ventas.

  • Aprendizaje y desarrollo

    • Crear y preconfigurar reuniones para la capacitación
    • Asigna roles de coorganizador a los capacitadores y a los líderes de sesión.
    • Recuperar grabaciones que permitan a los estudiantes revisar el material después de que finalice el curso

  • Operaciones de los desarrolladores

    • Crea reuniones para conectar a los compañeros de equipo de forma instantánea.
    • Permite que otras partes interesadas se unan a reuniones en curso compartiendo información de la reunión y de los participantes en tiempo real.
    • Ejecuta los datos de transcripción a través de modelos de IA para generar los próximos pasos correctos.
Crea y únete a una reunión dinámica con tus colegas en un espacio de Chat.
Figura 1: Crea y únete a una reunión dinámica con tus colegas en un espacio de Chat.

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

Términos comunes

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

Artefacto
Un archivo que genera Meet en respuesta a una conferencia, como grabaciones y transcripciones. Por lo general, un artefacto está listo para recuperarlo poco después de que finaliza una conferencia.
Evento de calendario
Un evento en el Calendario de Google con varios asistentes, que suele crear un organizador de reuniones y que contiene la información de unión a una reunión. Meet puede ser la solución de conferencia para el evento.
Llamada
Una sesión con 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 dentro de un espacio de reunión. Por lo general, los usuarios consideran esta situación como una sola reunión.
Co-host
Es una persona en una llamada a la que un organizador le otorgó privilegios de administración de organizadores, excepto la capacidad de quitar al organizador original.
Host
La persona que creó una llamada (el organizador de la reunión) o la persona que controla la llamada. Ten en cuenta que el organizador de una reunión puede organizarla, pero no estar presente cuando se lleva a cabo. Los organizadores también pueden delegar privilegios a un coorganizador.
Código de reunión

Es una cadena única de 10 caracteres que se puede escribir para un espacio de reunión que se usa dentro del URI de reunión de un espacio de reunión. 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 pueden disociarse de un espacio de reuniones y reutilizarse para diferentes espacios 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 Obtén más información sobre los códigos de reunión de Google Meet.

Nombre de la reunión

Es un ID único generado por el servidor que se usa para identificar un espacio de reunión. Distingue mayúsculas de minúsculas. Por ejemplo, jQCFfuBOdN5z 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ó el espacio de reunión. Este usuario también se puede considerar el propietario de la reunión. Es posible que no esté presente durante la llamada o que sea el anfitrión de la reunión. Solo puede haber un organizador de reuniones.

Espacio de reuniones

Es un lugar virtual o un objeto persistente (como una sala de reuniones) en el que se lleva a cabo una conferencia. Solo se puede realizar una conferencia activa en un espacio a la vez. Un espacio de reuniones también ayuda a los usuarios a reunirse y encontrar recursos compartidos.

URI de la reunión

Es una URL en la que se puede hacer clic que inicia o une a un usuario a una llamada. 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, que mira como un usuario, o un dispositivo de sala conectado a una llamada. Hay un recurso conferenceRecords.participants para cada persona. Cuando un participante se une a la conferencia, se le asigna un ID único.

Sesión del participante

Es un ID de sesión único que se crea para cada par de 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-dispositivo, se le asignan IDs de sesión únicos.