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. Un espacio de reuniones también ayuda a los usuarios a reunirse 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 reunión. También contiene el objeto ActiveConference, que es un vínculo al recurso conferenceRecords actual dentro del espacio de la reunión. Para obtener más información sobre cómo administrar una sala de reuniones, consulta Crea y administra salas de reuniones.
En las siguientes secciones, se detalla cómo configurar un espacio de reunión con estos objetos y métodos.
Cómo establecer 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.
Acceder 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 automáticamente que los asistentes se unan. El campo se establece de forma predeterminada según 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 reuniones, configura el campo entryPointAccess con el objeto EntryPointAccess. Se establece en ALL para permitir todos los puntos de entrada o en CREATOR_APP_ONLY para limitar los puntos de entrada solo a los 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 del espacio de reunión, configura el campo booleano attendanceReportGenerationType con el objeto AttendanceReportGenerationType. 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.
Salas de reuniones medianas
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 ella 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 del espacio.
Para definir restricciones de funciones cuando la reunión está moderada (moderation es on), configura el campo moderationRestrictions con el objeto ModerationRestrictions. Las restricciones definen quién tiene permiso en el espacio de la reunión para enviar mensajes de chat o reacciones, o para compartir su pantalla.
Para establecer las restricciones de funciones 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 coorganizador de la reunión, o como NO_RESTRICTION para aplicarlos a todos los participantes.
Para restringir el rol predeterminado asignado a los usuarios como visualizadores, configura el campo booleano defaultJoinAsViewerType con el enum DefaultJoinAsViewerType. Si defaultJoinAsViewerType es on, los usuarios se unen como espectadores. 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 función "Toma notas por mí" dentro del espacio de la reunión. Cuando se habilitan estos parámetros de configuración, se graba el espacio de la reunión, se generan transcripciones y se capturan y organizan automáticamente las notas de la reunión en Documentos de Google. Cada función es independiente y se configura 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. 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 alcance de OAuth meetings.space.settings. Para obtener más información, consulta Permisos de OAuth para la configuración.
Para establecer 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 establecer cada objeto, usa el enum booleano AutoGenerationType para activar o desactivar el objeto de configuración on o off.
Permisos de OAuth para la configuración
Para establecer la configuración de las reuniones o acceder a ella, 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 |
| Obtener o enumerar artefactos de conferencias creadas por otras apps | https://www.googleapis.com/auth/meetings.space.readonly |
| Obtener o enumerar 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 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 más información sobre los permisos de OAuth, consulta Conoce los permisos de la API de REST.
Administra los miembros del espacio
Si bien los organizadores de la reunión siempre pueden ingresar sin pedir permiso, también puedes configurar a otros miembros para que se unan sin pedir permiso.
Además, se puede configurar a los miembros para que tengan un rol 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 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, que mira como oyente o que usa un dispositivo de sala conectado a una llamada. Hay un recurso de 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 de acceso con los métodos de creación y lista que usan el campo parent para denotar 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, 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 la respuesta. Un FieldMask es una forma en que los llamadores de la API pueden enumerar los campos que debe devolver una solicitud. Es una lista de campos delimitada por comas para especificar que solo se usan ciertos campos en un objeto y los demás no se modifican.
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 create, get y list. 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.