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 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 salas de reuniones, consulta Crea y administra salas de reuniones. 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 reuniones

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 ajustes x
     con una conferencia activa x x
patch x

Cómo identifica Meet un espacio de reunión

La API de REST de Google 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 llamar 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 solo consta de dígitos decimales y su 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 de 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 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 y unirse a una conferencia de Meet. 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 campo name:

  • 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 Cómo obtener 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 reuniones.

  • Para finalizar una conferencia activa en un espacio de reunión, solo puedes usar spaces/{space}. Para obtener más información, consulta Cómo finalizar una 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: Es el 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.

  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 del espacio de la reunión, comenzará la 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 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 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.