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

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

  • Crea y configura espacios de reunión para conectar a los usuarios por video.
  • Configura previamente los niveles de acceso al espacio, la configuración de moderación y las grabaciones o transcripciones automáticas.
  • Administrar a los miembros del espacio de reunión y asignar roles de coanfitrión
  • Finaliza un programa de conferencia activo de forma programática dentro de un espacio de reunión.
  • Obtén registros de conferencias, detalles de asistencia y metadatos de sesiones de participantes.
  • Recuperar artefactos de 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 reuniones específico o a todos los espacios de reuniones que pertenecen a un usuario específico. Para obtener más información, consulte:

Casos de uso

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

  • Antes de una conferencia: Crea espacios de reunión a pedido, configura previamente las restricciones de acceso (abierto, de confianza o restringido), aplica controles de moderación (compartir pantalla, chat, reacciones, micrófono y cámara), configura la grabación o transcripción automáticas y asigna miembros del espacio con roles de coanfitrión.

  • Durante una conferencia: Recupera los metadatos de la conferencia activa y las sesiones de los participantes, administra miembros de forma dinámica, escucha los eventos del ciclo de vida en tiempo real con la API de Google Workspace Events o finaliza la conferencia activa de forma programática.

  • Después de una conferencia: Recupera los registros de la conferencia y los registros de asistencia, descarga las grabaciones y las transcripciones de Documentos de Google desde Google Drive, y accede a entradas de voz de transcripción detalladas para el entrenamiento, el cumplimiento o el análisis de IA.

Estos son algunos ejemplos de lo que puedes hacer con la API de REST de Meet:

  • Administración de ventas y cuentas

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

  • Aprendizaje y desarrollo

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

  • Asistencia al cliente y consultoría

    • Crea espacios de reunión seguros y restringidos directamente desde los tickets del departamento de ayuda o los portales de clientes.
    • Configura previamente la administración del anfitrión para que solo los agentes de asistencia puedan presentar o administrar la asistencia.
    • Habilita la grabación o transcripción automática para el control de calidad y los registros de cumplimiento.
    • Finaliza de forma programática las conferencias activas cuando concluyen las citas o las sesiones de asistencia.

  • Operaciones para desarrolladores

    • Crea reuniones para conectar a los miembros del equipo al instante.
    • Permite que otros interesados se unan a las reuniones en curso compartiendo información en tiempo real sobre la reunión y los participantes.
    • Ejecutar 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, en tu app para llevar la colaboración aún más lejos. Para obtener más información, consulta Casos de uso del chat.

Términos comunes

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

Conferencia activa
La conferencia en curso que se lleva a cabo dentro de un espacio de reuniones. Solo se puede realizar una conferencia activa en un espacio de reunión en un momento determinado. Una vez que finaliza, se convierte en un registro histórico de la conferencia.
Artefacto
Un archivo que genera Meet en respuesta a una conferencia, como recordings y transcripts. Los artefactos se guardan en la unidad de 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
Evento en el Calendario de Google con varios asistentes, que suele crear un organizador de reuniones y que contiene la información para unirse a una reunión. Es posible que Meet sea 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
Co-host
Persona en una llamada a la que un organizador le otorgó privilegios de administración del organizador, excepto la capacidad de quitar al organizador original.
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.
Récord de la conferencia
Es un ID único para cada instancia de una conferencia. Se crea automáticamente cuando comienza la conferencia. El recurso conferenceRecords usa el formato conferenceRecords/{conferenceRecord}. Por ejemplo, conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ.
Llamar para entrar a la reunión
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 el organizador puede organizar la reunión, pero no estar presente cuando se lleve a cabo. Un anfitrión también puede delegar privilegios de anfitrión a un coanfitrión.
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 se deben almacenar a largo plazo, ya que pueden disociarse de un espacio de reunión y reutilizarse 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 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 reunión se devuelve en el campo name de un recurso spaces. Para obtener más información, consulta Cómo identifica Meet un espacio de reunión.

Organizador de la reunión

Es el usuario que creó el espacio de reunión. Este usuario también se puede considerar como el propietario de la reunión. Es posible que no estén presentes durante la llamada o que no sean 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 lleva a cabo una conferencia. Solo se puede realizar una reunión 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 para iniciar o unirse a una llamada. Cada llamada tiene una URL única que consta de https://meet.google.com/ seguido del código de la reunión. Por ejemplo, https://meet.google.com/abc-mnop-xyz.

Miembro

Usuario que se agregó explícitamente a un espacio de reunión con un rol designado (como COHOST). A diferencia de un participante que está presente solo durante una conferencia en vivo, un miembro se asocia con el espacio de reunión persistente y conserva sus privilegios en varias conferencias en ese espacio.

Participante

Una persona que se unió a una llamada o que usa el Modo complementario, que mira como espectador o un dispositivo de sala conectado a una llamada Hay un recurso de 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 dispositivo y participante que se une a una llamada. Hay un recurso participantSessions para cada sesión. Si el participante se une a la misma llamada varias veces desde el mismo par dispositivo-participante, se le asigna un ID de sesión único cada vez.

Grabación

Archivo de video MP4 y metadatos asociados que se generan cuando se graba una conferencia. Las grabaciones se guardan en la unidad de Drive del organizador de la reunión y se pueden recuperar como artefactos de la reunión.

Dirección SIP

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

Transcripción

Un documento de texto que captura la conversación hablada de una conferencia, exportado a la unidad de Drive del organizador de la reunión como un archivo de Documentos.

Entrada de transcripción

Segmento discreto de voz transcrita de un participante en una conferencia. Cada entrada incluye la identidad del participante, la marca de tiempo, el texto hablado y el código de idioma, y está disponible durante 30 días después de que finaliza la conferencia.