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.
  • 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 artefactos de la reunión (grabaciones, transcripciones y entradas de transcripciones)

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

Artefacto
Un archivo que genera Google 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 la reunión y que contiene la información para unirse a una reunión. Meet podría ser la solución de conferencias 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.
Host
La persona que creó la 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 se puede escribir 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. 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.
Sala de reuniones
Es un lugar virtual o un objeto persistente (como una sala de reuniones) donde se realizan conferencias. 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 unió a una llamada o que usa el Modo complementario, mirando como un espectador 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, se le asignarán IDs de sesión únicos a cada uno.

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.

  • Para obtener información sobre cómo desarrollar con las APIs de Google Workspace, incluido el manejo de la autenticación y la autorización, consulta Desarrolla en Google Workspace.

  • Para obtener información sobre cómo crear una sala de reuniones con la API de REST de Meet, lee la guía Trabaja con salas de reuniones.