Configure meeting spaces and members

A meeting space represents a virtual place or a persistent object (such as a meeting room) where conferences are held. A meeting space also helps users meet and find shared resources.

When you create a meeting space using the spaces.create method, it returns an instance of a spaces resource. The resource includes the SpaceConfig object that's the configuration for the meeting space. It also contains the ActiveConference object that's a link to the current conferenceRecords resource within the meeting space. For more information on managing a meeting space, see Create and manage meeting spaces .

The following sections detail how to configure a meeting space using these objects and methods.

Set moderation and meeting access

You can set how users join a meeting, the moderation modes, the feature restrictions, and the permissions users receive when they join a meeting, through the SpaceConfig object.

Access meeting spaces

To determine who can join a meeting space without knocking, set the accessType field using the AccessType object. You can choose from multiple settings on whether to automatically allow attendees to join. The field defaults to the user's default access settings.

To define the entry points that can be used to join meetings hosted in a meeting space, set the entryPointAccess field using the EntryPointAccess object. Set to ALL to allow all entry points or CREATOR_APP_ONLY to scope the entry points to only those owned by the Google Cloud project that created the meeting space.

Moderate meeting spaces

To moderate a meeting, you can set the moderation field using the Moderation object. When the moderation mode is on , the meeting organizer has control over the meeting with features such as co-host management (see spaces.members ) and feature restrictions using the moderationRestrictions field. For more information on members, see Manage space members .

To define feature restrictions when the meeting is moderated ( moderation is on ), set the moderationRestrictions field using the ModerationRestrictions object. The restrictions define who has permission within the meeting space to send chat messages or reactions, or to share their screen.

To set the feature restrictions on the moderationRestrictions field, use the RestrictionType to apply the chatRestriction , reactionRestriction , presentRestriction . Set to HOSTS_ONLY to apply the permissions to both the meeting organizer and co-host, or NO_RESTRICTION to apply to all participants.

To restrict the default role assigned to users as viewer, set the boolean defaultJoinAsViewerType field using the DefaultJoinAsViewerType . If defaultJoinAsViewerType is on , users join as viewers. If off , users join as contributors. Default is off . If an explicit role is set for a user in spaces.members , the user joins as that role.

Generate attendance report

To create an attendance report for the meeting space, set the attendanceReportGenerationType field using the AttendanceReportGenerationType object. If a report is requested, Google Meet saves the attendance report to the meeting organizer's Google Drive and an email is also sent.

Manage auto artifacts

Meeting organizers, but not co-hosts, can pre-configure auto-recording, auto-transcripts, and smart notes within the meeting space. When these settings are enabled, the meeting space is recorded, transcripts are generated, and meeting notes are captured and organized into Google Docs automatically. Each feature is independent and is set per meeting space. Recording captions are only available in English.

You can pre-configure the auto artifacts either when you create a meeting space or once the meeting space is created. Both methods require the meetings.space.settings OAuth scope. For more information, see OAuth scopes for settings .

You can also set up auto artifacts for meetings created from Google Calendar.

To set auto artifacts, use the ArtifactConfig object, within the SpaceConfig object. ArtifactConfig is made up of the recordingConfig , transcriptionConfig , and smartNotesConfig fields.

Each field is mapped to a similar object such as RecordingConfig , TranscriptionConfig , and SmartNotesConfig . To set each object, use the AutoGenerationType to toggle the config object on or off .

To retrieve the artifacts created during a conference, see Work with artifacts .

Difference between transcripts and smart notes

While both meeting transcripts and smart notes (also known as "take notes for me") capture information from your meeting, these features serve different purposes and produce different artifacts.

The following table shows how they differ:

Feature Transcripts Smart notes
Overview
A verbatim, word-for-word record. A concise summary of key points generated by Gemini.
Detail level
100% detail. Everything said is written down. High-level. Focuses on decisions and action items.
Use case
Legal compliance, checking exact quotes, and user accessibility. Allows late participants to catch up instantly; automates minute-taking and project tracking.
Real-time usage
Used for captions. The file is generated after the call. You can view the summary building in the side panel during the call.
Output
A long Google Docs document with speaker name and timestamps. A concise Google Docs document of meeting notes with sections and bullet points.
Citation
Contains the full text that can be linked to. Includes citations (timestamps) that link back to the specific moment in the transcript for context, if both transcripts and smart notes are enabled. For more information, see When both features are enabled .

When both features are enabled

While each feature can be used separately, both transcripts and smart notes can also be used at the same time to create better post-meeting artifacts.

When both are enabled, you'll see citations in your generated smart notes document. These citations are located throughout the details section and link to specific timestamps in the meeting transcript. By clicking on these citations, you can jump directly to the relevant section in the transcript to gain a deeper understanding of the discussion.

During the meeting, participants see indicators that both features are active. They must remain active for the duration of the meeting to generate clickable citations. Even though the files are interlinked, the system still generates two distinct documents in the host's Google Drive. Both files are also automatically attached to the Google Calendar event.

OAuth scopes for settings

Setting or accessing meetings settings requires the following OAuth scopes:

Use case Scope code
Set auto artifact generation for spaces created by other apps. https://www.googleapis.com/auth/meetings.space.settings
Get or list artifacts from conferences created by other apps. https://www.googleapis.com/auth/meetings.space.readonly
Get or list other pre-meeting settings of a meeting space created by a third-party app. https://www.googleapis.com/auth/meetings.space.created
https://www.googleapis.com/auth/meetings.space.readonly
Read and edit the settings for all meeting spaces a user can access through any other app, such as Calendar. https://www.googleapis.com/auth/meetings.space.settings

For more information on OAuth scopes, see Meet REST API scopes .

Manage space members

A space member is a user who's configured to have a role in the meeting space. These users can join the meeting space without requesting permission to connect (also known as "knocking").

While meeting organizers can automatically enter the meeting space, you can also configure additional members to join the meeting without knocking. Additionally, members can be configured to have a Role in the meeting, such as COHOST which gives them the same abilities to manage the meeting as the meeting organizer. For more information about accessing a meeting space without knocking, see AccessType .

The spaces.members resource includes the name , user , and role fields.

Note that a member is different from a participant . A participant is a person joined to a call or that uses Companion mode , watching as a viewer, or a room device connected to a call. There's one conferenceRecords.participants resource for each person.

You can manage space members using the following methods:

Each method takes a path parameter with the create and list methods using the parent field to denote the meeting space, and the delete and get methods using the name field to filter the results based on the meeting space and the member name. All methods, except delete, return an instance of the spaces.members resource.

All methods, except delete, support the fields parameter in SystemParameterContext . When the fields parameter is omitted, the API response defaults to "name,email,role,user" .

The fields parameter relies on a FieldMask for response filtering. A FieldMask is a way for API callers to list fields a request should return. It's a comma-delimited list of fields to specify only certain fields in an object are used while leaving the other fields unchanged. Using a FieldMask allows the API to avoid unnecessary work and improves performance. A field mask is used for create, get, and list methods. For more information on field masks, see Google Sheets API's Use field masks .

Design a Mobile Site
View Site in Mobile | Classic
Share by: