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 tus usuarios directamente desde tu app.

Con la API de REST de Meet, puedes hacer lo siguiente:

  • Crear un espacio de reunión para conectar a los usuarios por video
  • Obtener un espacio de reunión o una conferencia por nombre de recurso
  • Obtener una lista de participantes y sesiones de participantes
  • Obtener 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 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 lo siguiente:

Casos de uso

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

  • Antes de una conferencia: Adapta la experiencia de la conferencia según sea necesario creando el espacio de reunión. También puedes administrar a los invitados y configurar los parámetros de configuración previamente.

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

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

Estos son algunos ejemplos de lo que podrías usar la API de REST de Meet:

  • Ventas y administración de cuentas

    • Recupera información de la reunión y de los participantes para fines de registro.
    • Recupera los 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 capacitación y eficacia de ventas.

  • Aprendizaje y desarrollo

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

  • Operaciones para desarrolladores

    • Crea reuniones para conectar instantáneamente a los compañeros de equipo.
    • Permite que otras partes interesadas se unan a las reuniones en curso compartiendo información de la reunión y de los participantes en tiempo real.
    • Ejecuta 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 una reunión dinámica y únete a ella con tus colegas en un espacio de Chat.

También puedes incorporar otras APIs de Google Workspace, como la API de Chat, en 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 incluye una lista de términos comunes que se usan en esta API:

Artefacto
Un archivo generado por Meet en respuesta a una conferencia, como recordings y transcripts. Los artefactos se guardan en la unidad de Google Drive del organizador de la reunión. Por lo general, están listos para recuperarse poco después de que finaliza una conferencia.
Evento de calendario
Un evento en Calendario de Google con varios asistentes, que suele crear un organizador de la 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.
Call
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.
Registro de conferencia
Un ID único para cada instancia de una conferencia. Se crea automáticamente cuando comienza la conferencia. El conferenceRecords recurso usa el formato conferenceRecords/{conferenceRecord}. Por ejemplo, conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ.
Co-host
Una persona en una llamada a la que un host le otorgó privilegios de administración de host, excepto la capacidad de quitar al host original.
Dial in
Usar un teléfono para participar en una llamada o escuchar una llamada transmitida.
Host
La persona que creó una llamada (el organizador de la reunión) o la persona que controla la llamada. Ten en cuenta que un organizador de la reunión puede organizar la reunión, pero no estar presente cuando se lleva a cabo. Un host también puede delegar privilegios de host a un co-host.
Código de reunión

Una cadena única de 10 caracteres que se puede escribir para un espacio de reunión que se usa dentro del URI de la 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 se deben almacenar a largo plazo, ya que pueden disociarse de un espacio de reunión y se pueden volver a usar para diferentes espacios de reunión en el futuro. Por lo general, los códigos de reunión caducan 365 días después del último uso. Para obtener más información, consulta Obtén información sobre los códigos de reunión de Google Meet.

Nombre de la reunión

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 name campo de un spaces recurso. Para obtener más información, consulta Cómo Meet identifica un espacio de reunión.

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 host de la reunión. Solo puede haber un organizador de la reunión.

Sala de reuniones

Un lugar virtual o un objeto persistente (como una sala de reuniones) donde se lleva a cabo una conferencia. Solo se puede realizar una conferencia activa en un espacio en cualquier momento. Un espacio de reunión 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 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 unida a una llamada o que usa el Modo complementario, que mira como espectador o un dispositivo de sala conectado a una llamada. Hay un participants recurso para cada persona. Cuando un participante se une a la conferencia, se le asigna un ID único.

Sesión de participante

Un ID de sesión único creado para cada par de dispositivos y participantes que se une a una llamada. Hay un participantSessions recurso para cada sesión. Si el participante se une a la misma llamada varias veces desde el mismo par de dispositivos y participantes, se le asignan IDs de sesión únicos.

Dirección SIP

Una dirección de protocolo de inicio de sesión (SIP) detalla cómo el hardware de videoconferencias externo puede encontrar una conferencia de Meet y unirse a ella. Meet admite el esquema de URI SIP.