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 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 reunión, consulta Cómo trabajar con espacios de reunión.
En las siguientes secciones, se detalla cómo configurar un espacio de reunión con varios métodos y objetos beta nuevos.
Cómo configurar la moderación y el acceso a las reuniones
Con los nuevos objetos en versión beta, ahora puedes establecer modos de moderación, restricciones de funciones y los permisos que reciben los usuarios cuando se unen a una reunión. Estos se configuran a través del objeto SpaceConfig actualizado.
El campo moderation es un modo de moderación preconfigurado para una reunión, con el valor predeterminado controlado por las políticas del usuario. Usa el objeto Moderation. Cuando el modo de moderación está activado, el organizador de la reunión tiene control sobre esta con funciones como la administración de coanfitriones (consulta spaces.members) y las restricciones de funciones (consulta moderationRestrictions). Para obtener más información sobre los miembros, consulta Cómo administrar miembros de un espacio.
El campo moderationRestrictions aplica restricciones de moderación a la reunión cuando moderation está activado. Usa el objeto ModerationRestrictions. Las restricciones definen quién tiene permiso para enviar reacciones y mensajes de chat, compartir su pantalla y si se debe restringir el rol predeterminado asignado a los usuarios como usuarios. El campo moderationRestrictions depende de un RestrictionType para aplicar las tres primeras restricciones. El RestrictionType se puede aplicar al organizador y al coorganizador de la reunión, o a todos los participantes. DefaultJoinAsViewerType aplica el permiso final en el que los usuarios se unen como colaboradores de forma predeterminada, pero los anfitriones también pueden restringir a los usuarios para que se unan como usuarios.
El campo firstJoinerType establece si los usuarios pueden unirse antes que el organizador a las conferencias en este espacio de reuniones. Define qué usuarios pueden unirse a la reunión primero y si otros están en estado de espera. Usa el objeto FirstJoinerType.
Administra los miembros del espacio
Un organizador de reuniones siempre podía ingresar a la reunión sin solicitarlo, pero ahora puedes configurar miembros que también puedan unirse a la reunión sin solicitarlo.
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, que mira como un usuario o 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.
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 automáticamente el espacio de reunión, se generan transcripciones y se capturan y organizan las notas de la reunión en Documentos de Google. 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 lo hayas creado. Esta función también te permite configurar artefactos automáticos para las reuniones que se crean 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.
Los artefactos automáticos se establecen a través del objeto ArtifactConfig, en el objeto SpaceConfig, que forma parte del recurso spaces. ArtifactConfig se compone de los campos recordingConfig, transcriptionConfig y smartNotesConfig.
Cada campo se asigna a un objeto similar, como RecordingConfig, TranscriptionConfig y SmartNotesConfig. Cada objeto se establece con la enumeración booleana AutoGenerationType para activar o desactivar el objeto de configuración.
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.