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 reunión 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.
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 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 propietario de la reunión tiene control sobre la reunión 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 propietario 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
El propietario de una reunión siempre podía ingresar a ella sin solicitar acceso, pero ahora puedes configurar miembros que también puedan unirse sin solicitarlo. Además, los miembros se pueden configurar para que tengan un rol en la reunión, como COHOST, que les brinda las mismas capacidades para administrar la reunión que el propietario. 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 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.