Configura las salas de reuniones y los miembros

Un espacio de reunión representa un lugar virtual o un objeto persistente (como una sala de reuniones) donde se realizan conferencias. Un espacio de reunión también ayuda a los usuarios a reunirse y encontrar recursos compartidos.

Cuando creas un espacio de reunión con el spaces.create método, se muestra una instancia de un spaces recurso. El recurso incluye el SpaceConfig objeto que es la configuración del espacio de reunión. También contiene el ActiveConference objeto que es un vínculo al recurso conferenceRecords actual dentro del espacio de reunión. Para obtener más información sobre cómo administrar un espacio de reunión, consulta Crea y administra espacios de reunión.

En las siguientes secciones, se detalla cómo configurar un espacio de reunión con estos objetos y métodos.

Establece la moderación y el acceso a la reunión

Puedes configurar cómo se unen los usuarios a una reunión, los modos de moderación, las restricciones de funciones y los permisos que reciben los usuarios cuando se unen a una reunión a través del objeto SpaceConfig.

Accede a los espacios de reunión

Para determinar quién puede unirse a un espacio de reunión sin tocar, configura el accessType campo con el AccessType objeto. Puedes elegir entre varios parámetros de configuración para permitir automáticamente que se unan los asistentes. El campo se establece de forma predeterminada en la configuración de acceso predeterminada del usuario.

Para definir los puntos de entrada que se pueden usar para unirse a las reuniones alojadas en un espacio de reunión, configura el campo entryPointAccess con el objeto EntryPointAccess. Configura ALL para permitir todos los puntos de entrada o CREATOR_APP_ONLY para limitar los puntos de entrada solo a aquellos que pertenecen al proyecto de Google Cloud que creó el espacio de reunión.

Modera los espacios de reunión

Para moderar una reunión, puedes configurar el moderation campo con el Moderation objeto. Cuando el modo moderation está on, el organizador de la reunión tiene control sobre la reunión con funciones como la administración de coorganizadores (consulta spaces.members) y las restricciones de funciones con el moderationRestrictions campo. Para obtener más información sobre los miembros, consulta Administra los miembros del espacio.

Para definir las restricciones de funciones cuando se modera la reunión (moderation es on), configura el moderationRestrictions campo con el ModerationRestrictions objeto. Las restricciones definen quién tiene permiso dentro del espacio de reunión para enviar mensajes de chat o reacciones, o para compartir su pantalla.

Para establecer las restricciones de funciones en el moderationRestrictions campo, usa el RestrictionType para aplicar chatRestriction, reactionRestriction, presentRestriction. Configura HOSTS_ONLY para aplicar los permisos al organizador de la reunión y al coanfitrión, o NO_RESTRICTION para aplicarlos a todos los participantes.

Para restringir el rol predeterminado asignado a los usuarios como oyentes, configura el campo booleano defaultJoinAsViewerType con el DefaultJoinAsViewerType. Si defaultJoinAsViewerType es on, los usuarios se unen como oyentes. Si es off, los usuarios se unen como colaboradores. El valor predeterminado es off. Si se establece un rol explícito para un usuario en spaces.members, el usuario se une con ese rol.

Genera un informe de asistencia

Para crear un informe de asistencia para el espacio de reunión, configura el attendanceReportGenerationType campo con el AttendanceReportGenerationType objeto. Si se solicita un informe, Google Meet lo guarda en la unidad de Google Drive del organizador de la reunión y también se envía un correo electrónico.

Administra artefactos automáticos

Los organizadores de la reunión, pero no los coorganizadores, pueden configurar previamente la grabación automática, las transcripciones automáticas y las notas inteligentes dentro del espacio de reunión. Cuando se habilita esta configuración, se graba el espacio de reunión, se generan transcripciones y se toman notas de la reunión, que se organizan automáticamente en Documentos de Google. Cada función es independiente y se establece por espacio de reunión. Los subtítulos de grabación solo están disponibles en inglés.

Puedes configurar previamente los artefactos automáticos cuando creas un espacio de reunión o una vez que se crea el espacio de reunión. Ambos métodos requieren el permiso de OAuth meetings.space.settings. Para obtener más información, consulta Permisos de OAuth para la configuración.

También puedes configurar artefactos automáticos para las reuniones creadas desde Calendario de Google.

Para configurar artefactos automáticos, usa el ArtifactConfig objeto, dentro del SpaceConfig objeto. ArtifactConfig se compone de los campos recordingConfig, transcriptionConfig y smartNotesConfig.

Cada campo se asigna a un objeto similar, como RecordingConfig, TranscriptionConfig, y SmartNotesConfig . Para configurar cada objeto, usa el AutoGenerationType para activar o desactivar el objeto de configuración on o off.

Para recuperar los artefactos creados durante una conferencia, consulta Trabaja con artefactos.

Diferencia entre las transcripciones y las notas inteligentes

Si bien las transcripciones de reuniones y las notas inteligentes (también conocidas como "Toma notas por mí") capturan información de tu reunión, estas funciones cumplen propósitos diferentes y producen artefactos diferentes.

En la siguiente tabla, se muestran las diferencias:

Función Transcripciones Notas inteligentes
Descripción general Un registro textual, palabra por palabra. Un resumen conciso de los puntos clave generados por Gemini.
Nivel de detalle 100% de detalle. Se escribe todo lo que se dice. Descripción general. Se enfoca en las decisiones y los elementos de acción.
Caso práctico Cumplimiento de los requisitos legales, verificación de citas exactas y accesibilidad del usuario. Permite que los participantes que llegan tarde se pongan al día de inmediato; automatiza la toma de notas y el seguimiento de proyectos.
Uso en tiempo real Se usa para los subtítulos. El archivo se genera después de la llamada. Puedes ver el resumen que se genera en el panel lateral durante la llamada.
Resultado Un documento largo de Documentos de Google con el nombre del orador y marcas de tiempo. Un documento conciso de Documentos de Google con notas de la reunión, secciones y viñetas.
Citas Contiene el texto completo al que se puede vincular. Incluye citas (marcas de tiempo) que se vinculan al momento específico de la transcripción para obtener contexto, si se habilitan las transcripciones y las notas inteligentes. Para obtener más información, consulta Cuando se habilitan ambas funciones.

Cuando se habilitan ambas funciones

Si bien cada función se puede usar por separado, las transcripciones y las notas inteligentes también se pueden usar al mismo tiempo para crear mejores artefactos posteriores a la reunión.

Cuando ambas funciones estén habilitadas, verás citas en el documento de notas inteligentes generado. Estas citas aparecen en diferentes partes de la sección de detalles y se vinculan a marcas de tiempo específicas de la transcripción de la reunión. Si haces clic en las citas, puedes ir directamente a la sección correspondiente de la transcripción y comprender mejor de qué se estaba hablando.

Durante la reunión, los participantes ven indicadores de que ambas funciones están activas. Deben permanecer activos durante la reunión para generar citas en las que se pueda hacer clic. Aunque los archivos están interconectados, el sistema genera dos documentos distintos en la unidad de Google Drive del organizador. Ambos archivos también se adjuntan automáticamente al evento de Calendario de Google.

Permisos de OAuth para la configuración

Para configurar los parámetros de configuración de las reuniones o acceder a ellos, se requieren los siguientes permisos de OAuth:

Caso práctico Código de permiso
Establece la generación automática de artefactos para los espacios creados por otras apps. https://www.googleapis.com/auth/meetings.space.settings
Obtén o enumera artefactos de conferencias creadas por otras apps. https://www.googleapis.com/auth/meetings.space.readonly
Obtén 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
Lee y edita la configuración de todos los espacios de reunión 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 más información sobre los permisos de OAuth, consulta Permisos de la API de REST de Meet scopes.

Administra los miembros del espacio

Un miembro del espacio es un usuario configurado para tener un rol en el espacio de reunión. Estos usuarios pueden unirse al espacio de reunión sin solicitar permiso para conectarse (también conocido como "tocar").

Si bien los organizadores de la reunión pueden ingresar automáticamente al espacio de reunión, también puedes configurar miembros adicionales para que se unan a la reunión sin tocar. Además, los miembros se pueden configurar para que tengan un Role en la reunión, como COHOST, que les otorga las mismas capacidades para administrar la reunión que el organizador. Para obtener más información sobre cómo acceder a un espacio de reunión sin tocar, consulta AccessType.

El spaces.members recurso incluye los campos name, user y role.

Ten en cuenta que un miembro es diferente de un participante. Un participante es una persona que se unió a una llamada o que usa el modo Complementario, que mira como oyente o que usa un dispositivo de sala conectado a una llamada. Hay un conferenceRecords.participants recurso para cada persona.

Puedes administrar los miembros del espacio con los siguientes métodos:

Cada método toma un parámetro de ruta de acceso con los métodos de creación y lista que usan el campo parent para indicar el espacio de reunión, y los métodos de eliminación y obtención que usan el campo name para filtrar los resultados según el espacio de reunión y el nombre del miembro. Todos los métodos, excepto el de eliminación, muestran una instancia del recurso spaces.members.

Todos los métodos, excepto el de eliminación, admiten el fields parámetro en SystemParameterContext. Cuando se omite el parámetro fields, la respuesta de la API se establece de forma predeterminada en "name,email,role,user".

El parámetro fields se basa en FieldMask para el filtrado de respuestas. FieldMask es una forma para que los llamadores de la API enumeren los campos que debe mostrar una solicitud. Es una lista de campos delimitada por comas para especificar que solo se usan ciertos campos en un objeto, mientras que los demás campos permanecen sin cambios. El uso de FieldMask permite que la API evite el trabajo innecesario y mejore el rendimiento. Se usa una máscara de campo para los métodos de creación, obtención y lista. Para obtener más información sobre las máscaras de campo, consulta Usa máscaras de campo de la API de Hojas de cálculo de Google.