Descripción general de los espacios de reuniones de Google Meet

Crea un espacio de Google Meet con el método spaces.create

En esta guía, se explica cómo la API de REST de Google Meet te permite crear y administrar reuniones de Google Meet.

Un espacio de reunión representa un lugar virtual o un objeto persistente (como una sala de reuniones) en el que se llevan a cabo conferencias. 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.

Para trabajar con espacios de reuniones, consulta Administra espacios de reuniones. Para obtener información sobre cómo configurar un espacio de reunión de forma programática, consulta Configura los parámetros de configuración del espacio de reunión. Para administrar a los miembros del espacio de reunión, consulta Cómo administrar a los miembros del espacio de reunión.

Cómo llamar a los métodos del espacio de reuniones

En la siguiente tabla comparativa, se detallan los roles de reunión necesarios para usar los métodos del espacio de reunión:

Método Propietarios Participantes Otros
endActiveConference
get
     Con configuración
     con una conferencia activa
patch

Cómo identifica Meet un espacio de reunión

La API de REST de Meet genera un recurso spaces para cada espacio de reunión. El recurso spaces ofrece varios puntos de entrada para unirse a una conferencia.

En la siguiente tabla, se muestra cómo identificar y unirse a un espacio de reunión:

Nombre del campo Descripción
name Es el nombre del espacio. La cadena {space} es el identificador del recurso del espacio y tiene el formato spaces/{space}. Es un ID único generado por el servidor y distingue mayúsculas de minúsculas. Por ejemplo, spaces/jQCFfuBOdN5z.
meetingCode Es el alias del nombre del espacio. {meetingCode} es una cadena de caracteres única que se puede escribir y no distingue mayúsculas de minúsculas. Tiene el formato spaces/{meetingCode}. Por ejemplo, spaces/abc-mnop-xyz. La longitud máxima es de 128 caracteres. Forma parte de meetingUri: https://meet.google.com/abc-mnop-xyz.
phoneAccess Son los métodos de acceso telefónico para este espacio de reunión. El objeto phoneAccess contiene la información necesaria para marcar y entrar a una conferencia, incluidos los números de teléfono regionales para el espacio de la reunión y un código PIN específico para ese número de teléfono. El PIN consta solo de dígitos decimales y su longitud puede variar. Por ejemplo, "pin": 19707127300.

Al igual que la IU de Meet, el recurso spaces incluye un conjunto limitado de números de acceso telefónico. Puedes ver números de teléfono adicionales de un espacio de reunión agregando {meetingCode} a la siguiente URL: https://meet.google.com/tel/. Por ejemplo, https://meet.google.com/tel/abc-mnop-xyz.
gatewaySipAccess Son los métodos de acceso al Protocolo de inicio de sesión (SIP) para este espacio de reunión. Una dirección SIP detalla cómo el hardware de videoconferencias de terceros puede encontrar una conferencia de Meet y unirse a ella. El objeto gatewaySipAccess contiene un URI y un código de acceso numérico. Meet admite el esquema de URI de SIP.

Para administrar un espacio de reunión, usa los siguientes valores para el campo name:

Permisos de OAuth por caso de uso

En la guía Autenticación con Meet, se enumeran todos los alcances de la API de REST de Meet y sus niveles de sensibilidad de verificación. Sin embargo, cuando trabajas con espacios de reuniones, los requisitos de alcance varían según si tu app o una app externa (como Calendario de Google) creó el espacio.

En la siguiente tabla, se describen los permisos de OAuth necesarios según el caso de uso específico del espacio de reuniones:

Caso de uso Código de alcance
Establece la generación automática de artefactos para los espacios creados por otras apps. https://www.googleapis.com/auth/meetings.space.settings
Obtener o enumerar artefactos de conferencias creadas por otras apps https://www.googleapis.com/auth/meetings.space.readonly
Obtiene o enumera otros parámetros de configuración previos a la reunión de un espacio de reunión creado por una app de terceros. https://www.googleapis.com/auth/meetings.space.created
https://www.googleapis.com/auth/meetings.space.readonly
Leer y editar la configuración de todos los espacios de reuniones a los que un usuario puede acceder a través de cualquier otra app, como Calendario. https://www.googleapis.com/auth/meetings.space.settings

Para obtener una lista completa de todos los alcances admitidos y sus niveles de sensibilidad de autorización, consulta Acerca de los alcances de la API de REST de Meet.

Ciclo de vida de un espacio de reunión

Un espacio de reunión pasa por varios estados durante su ciclo de vida. En el siguiente diagrama, se muestran los pasos de alto nivel del ciclo de vida de un espacio de reunión:

Es el ciclo de vida del espacio de reuniones.
Figura 1: Ciclo de vida de un espacio de reuniones.

  1. Llamar spaces.create. Se crea el espacio de reunión y el objeto spaces que se devuelve contiene la cadena meetingUri. Luego, se distribuye el meetingUri a los participantes. Antes de que comience la conferencia, puedes configurar los ajustes de la sala de reuniones y administrar a los miembros de la sala de reuniones.

  2. Realiza una encuesta sobre el nuevo espacio de reuniones. Llama al método spaces.get para verificar el estado de la conferencia.

    En lugar de sondear, también puedes suscribirte a eventos de Meet para recibir notificaciones push.

  3. Iniciar la conferencia Cuando el primer participante haga clic en meetingUri dentro de la sala de reuniones, comenzará una conferencia. El objeto activeConference se propaga y se establece la cadena activeConference.conferenceRecord.

  4. (Opcional) Obtén datos de la conferencia. Durante una conferencia activa, puedes acceder a algunos valores de conferenceRecord. Por ejemplo, llama al método conferenceRecords.participants.list para ver a todos los participantes de la conferencia. También puedes acceder a esta información hasta 30 días después de la conferencia.

  5. (Opcional) Finaliza la conferencia. Durante la conferencia, el propietario de la reunión puede llamar al método spaces.endActiveConference para finalizar de forma programática una conferencia activa para todos los participantes.

  6. Finaliza la conferencia. Cuando el último participante se va, finaliza la conferencia.

  7. Sondea los artefactos posteriores a la conferencia. La conferencia finalizó (STATE=ENDED), pero aún no se generaron los artefactos. También se propagan los campos startTime y endTime de la conferencia. Debes sondear el extremo del artefacto hasta que el objeto del artefacto STATE lea FILE_GENERATED.

    En lugar de realizar sondeos, puedes suscribirte a los eventos de Meet para recibir notificaciones push.

  8. Obtén artefactos posteriores a la conferencia. Puedes recuperar artefactos, como grabaciones y transcripciones, una vez que se generen. Por ejemplo, llama al método conferenceRecords.recordings.get para obtener una grabación por ID de grabación.

    Cuando esté listo, se completará un URI para el objeto del artefacto y se devolverá como parte del objeto de recurso.