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

Ilustración de la API de REST de Google Meet

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

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

Para trabajar con espacios de reunión, consulta Crea y administra espacios. Para obtener información sobre cómo configurar un espacio de reunión de forma programática, consulta Configura espacios de reunión y miembros.

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

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

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

Cómo Meet identifica un espacio de reunión

La API de REST de Google Meet genera un spaces recurso 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 un espacio de reunión y unirse a él:

Nombre del campo Descripción
name El nombre del espacio. La cadena {space} es el identificador de recursos 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 El alias del nombre del espacio. El {meetingCode} es una cadena de caracteres única y escribible que no distingue mayúsculas de minúsculas. Tiene el formato como 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 Los métodos de acceso telefónico para este espacio de reunión. El objeto phoneAccess contiene la información necesaria para llamar a una conferencia, incluidos los números de teléfono regionales para el espacio de reunión y un código PIN específico para ese número de teléfono. El PIN solo consta de dígitos decimales y la longitud puede variar. Por ejemplo, "pin": 19707127300.

Al igual que en la IU de Meet, el recurso spaces incluye un conjunto limitado de números de acceso telefónico. Para ver números de teléfono adicionales para un espacio de reunión, agrega {meetingCode} a la siguiente URL: https://meet.google.com/tel/. Por ejemplo, https://meet.google.com/tel/abc-mnop-xyz.
gatewaySipAccess 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 videoconferencia 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 SIP.

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

  • Para obtener detalles sobre un espacio de reunión, puedes usar spaces/{space} o el alias spaces/{meetingCode}. Para obtener más información, consulta Obtén un espacio de reunión.

  • Para actualizar los detalles de un espacio de reunión, solo puedes usar spaces/{space}. Para obtener más información, consulta Actualiza un espacio de reunión.

  • Para finalizar una conferencia activa dentro de un espacio de reunión, solo puedes usar spaces/{space}. Para obtener más información, consulta Finaliza la conferencia activa.

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:

Ciclo de vida del espacio de reuniones
Figura 1. El ciclo de vida de un espacio de reunión

  1. Llama a spaces.create. Se crea el espacio de reunión y el objeto spaces que se muestra contiene la cadena meetingUri. Luego, se distribuye el meetingUri a los participantes.

  2. Sondea el nuevo espacio de reunión. Llama al spaces.get método para verificar el estado de la conferencia.

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

  3. Inicia la conferencia. Cuando el primer participante hace clic en meetingUri dentro del espacio de reunión, se inicia una conferencia. Se propaga el objeto activeConference 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 conferenceRecords.participants.list método 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 spaces.endActiveConference método 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 startTime y endTime para la conferencia. Debes sondear el extremo del artefacto hasta que el objeto del artefacto STATE lea FILE_GENERATED.

    En lugar de sondear, puedes suscribirte a 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 conferenceRecords.recordings.get método para obtener una grabación por ID de grabación.

    Una vez que esté listo, se propagará un URI al objeto del artefacto y se mostrará como parte del objeto de recurso.