Un espacio de reunión representa un lugar virtual o un objeto persistente (como una sala de reuniones) donde se llevan a cabo conferencias. Un espacio de reuniones también ayuda a los usuarios a encontrarse y encontrar recursos compartidos.
Cuando creas un espacio de reunión con el método spaces.create, se muestra una instancia de un recurso spaces. El recurso incluye el objeto SpaceConfig que es la configuración del espacio de reuniones. También contiene el objeto ActiveConference, que es un vínculo al recurso conferenceRecords actual dentro del espacio de reuniones. Para obtener más información sobre cómo administrar un espacio de reuniones, consulta Cómo crear y administrar espacios de reuniones.
En las siguientes secciones, se detalla cómo configurar un espacio de reunión con estos métodos y objetos.
Cómo configurar la moderación y el acceso a las reuniones
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 cuando se unen a una reunión a través del objeto SpaceConfig.
Accede a salas de reuniones
Para determinar quién puede unirse a un espacio de reunión sin solicitarlo, configura el campo accessType con el objeto AccessType.
Puedes elegir entre varios parámetros de configuración para permitir que los asistentes se unan automáticamente. El campo usa de forma predeterminada la configuración de acceso predeterminada del usuario.
Para definir los puntos de entrada que se pueden usar para unirse a reuniones alojadas en un espacio de reuniones, configura el campo entryPointAccess con el objeto EntryPointAccess. Establece 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.
Genera un informe de asistencia
Para crear un informe de asistencia para el espacio de reuniones, configura el campo booleano attendanceReportGenerationType con el objeto AttendanceReportGenerationType. Si se solicita un informe, Google Meet lo guarda en Google Drive del organizador de la reunión y también se envía un correo electrónico.
Modera las salas de reuniones
Para moderar una reunión, puedes configurar el campo booleano moderation con el objeto Moderation.
Cuando el modo moderation es 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 campo moderationRestrictions. Para obtener más información sobre los miembros, consulta Cómo administrar miembros de un espacio.
Para definir restricciones de funciones cuando la reunión está moderada (moderation es on), establece el campo moderationRestrictions con el objeto ModerationRestrictions. Las restricciones definen quiénes tienen permiso dentro del espacio de reunión para enviar mensajes de chat o reacciones, o para compartir su pantalla.
Para establecer las restricciones de componentes en el campo moderationRestrictions, usa la enumeración RestrictionType para aplicar chatRestriction, reactionRestriction y presentRestriction. Configúralo como HOSTS_ONLY para aplicar los permisos al organizador y al coanfitrión de la reunión, o NO_RESTRICTION para aplicarlos a todos los participantes.
Para restringir el rol predeterminado asignado a los usuarios como usuarios, establece el campo booleano defaultJoinAsViewerType con la enumeración DefaultJoinAsViewerType. Si defaultJoinAsViewerType es on, los usuarios se unen como usuarios. Si es off, los usuarios se unen como colaboradores. La cantidad predeterminada es off. Si se establece un rol explícito para un usuario en spaces.members, el usuario se une con ese rol.
Administra artefactos automáticos
Los organizadores de reuniones, pero no los coorganizadores, pueden configurar previamente la grabación automática, las transcripciones automáticas y la opción “Tomar notas por mí” en el espacio de reunión. Cuando se habilita esta configuración, se graba el espacio de la reunión, se generan transcripciones y se capturan y organizan las notas de la reunión en Documentos de Google automáticamente. Cada función es independiente y se establece por espacio de reunión. Los subtítulos de las grabaciones solo están disponibles en inglés.
Puedes preconfigurar los artefactos automáticos cuando creas un espacio de reunión o una vez que se crea. Esta función también te permite configurar artefactos automáticos para las reuniones creadas desde el Calendario de Google. 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.
Para configurar artefactos automáticos, usa el objeto ArtifactConfig en el objeto SpaceConfig. 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 la enumeración booleana AutoGenerationType para activar o desactivar el objeto de configuración on o off.
Permisos de OAuth para la configuración
Para configurar reuniones o acceder a su configuración, se requieren los siguientes permisos de OAuth:
| 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 |
| Obtén artefactos de conferencias creadas por otras apps o crea una lista de ellos. | https://www.googleapis.com/auth/meetings.space.readonly |
| Obtener o mostrar 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.createdhttps://www.googleapis.com/auth/meetings.space.readonly |
| Leer y editar 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 Meet.
Administra los miembros del espacio
Si bien los organizadores de la reunión siempre pueden ingresar sin pedir permiso, también puedes configurar miembros adicionales para que se unan a la reunión sin pedir permiso.
Además, se puede configurar a los miembros para que tengan un rol en la reunión, como COHOST, que les brinda 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 llamar, consulta AccessType.
El recurso spaces.members 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, mira como un usuario o es un dispositivo de sala conectado a una llamada. Hay un recurso conferenceRecords.participants para cada persona.
Puedes administrar los miembros del espacio con los siguientes métodos:
Cada método toma un parámetro de ruta 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 delete, admiten el parámetro fields 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 un FieldMask para filtrar respuestas. Una máscara de campo es una forma para que los emisores de la API enumeren los campos que debe mostrar una solicitud. Es una lista de campos delimitados por comas para especificar que solo se usan ciertos campos en un objeto y no se modifican los demás.
El uso de una FieldMask permite que la API evite el trabajo innecesario y mejora 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 en la API de Hojas de cálculo de Google.