会議スペースとメンバーを構成する

会議スペースは、会議が開催される仮想の場所または永続オブジェクト（会議室など）を表します。会議スペースは、ユーザーが会議に参加して共有リソースを見つけるのにも役立ちます。

spaces.create メソッドを使用して会議スペースを作成すると、spaces リソースのインスタンスが返されます。このリソースには、会議スペースの構成である SpaceConfig オブジェクトが含まれています。また、会議スペース内の現在の conferenceRecords リソースへのリンクである ActiveConference オブジェクトも含まれています。会議スペースの管理について詳しくは、会議スペースの作成と管理をご覧ください。

以降のセクションでは、これらのオブジェクトとメソッドを使用して会議スペースを構成する方法について詳しく説明します。

管理機能と会議へのアクセスを設定する

SpaceConfig オブジェクトを使用して、ユーザーが会議に参加する方法、モデレーション モード、機能制限、ユーザーが会議に参加したときに付与される権限を設定できます。

会議スペースにアクセスする

参加リクエストなしで会議スペースに参加できるユーザーを決定するには、AccessType オブジェクトを使用して accessType フィールドを設定します。参加者が自動的に参加できるようにするかどうかについて、複数の設定から選択できます。このフィールドは、デフォルトでユーザーのデフォルトのアクセス設定になります。

会議スペースでホストされている会議に参加するために使用できるエントリ ポイントを定義するには、EntryPointAccess オブジェクトを使用して entryPointAccess フィールドを設定します。すべてのエントリ ポイントを許可する場合は ALL に設定し、会議スペースを作成した Google Cloud プロジェクトが所有するエントリ ポイントのみにスコープを設定する場合は CREATOR_APP_ONLY に設定します。

出席レポートを生成する

会議スペースの出席レポートを作成するには、AttendanceReportGenerationType オブジェクトを使用してブール値の attendanceReportGenerationType フィールドを設定します。レポートがリクエストされると、Google Meet は出席レポートを会議の主催者の Google ドライブに保存し、メールも送信します。

会議スペースを管理する

会議を管理するには、Moderation オブジェクトを使用してブール値の moderation フィールドを設定します。moderation モードが on の場合、会議の主催者は、共同主催者の管理（spaces.members を参照）や moderationRestrictions フィールドを使用した機能制限などの機能を使用して、会議を制御できます。メンバーの詳細については、Space のメンバーを管理するをご覧ください。

会議が管理されている場合（moderation が on の場合）に機能制限を定義するには、ModerationRestrictions オブジェクトを使用して moderationRestrictions フィールドを設定します。制限では、会議スペース内でチャット メッセージやリアクションを送信したり、画面を共有したりする権限を持つユーザーを定義します。

moderationRestrictions フィールドに機能制限を設定するには、RestrictionType 列挙型を使用して chatRestriction、reactionRestriction、presentRestriction を適用します。会議の主催者と共同主催者の両方に権限を適用する場合は HOSTS_ONLY に設定し、すべての参加者に適用する場合は NO_RESTRICTION に設定します。

ユーザーに割り当てられるデフォルトのロールを閲覧者として制限するには、DefaultJoinAsViewerType 列挙型を使用してブール値の defaultJoinAsViewerType フィールドを設定します。defaultJoinAsViewerType が on の場合、ユーザーは視聴者として参加します。off の場合、ユーザーは投稿者として参加します。デフォルトは off です。spaces.members でユーザーに明示的なロールが設定されている場合、ユーザーはそのロールとして参加します。

自動アーティファクトを管理する

会議の主催者は、会議スペース内で自動録画、自動文字起こし、[メモの作成を依頼] を事前に設定できますが、共同主催者はできません。これらの設定を有効にすると、会議スペースの録画、文字起こしの生成、会議メモのキャプチャと Google ドキュメントへの整理が自動的に行われます。各機能は独立しており、会議スペースごとに設定されます。録音の字幕は英語でのみご利用いただけます。

自動アーティファクトは、会議スペースの作成時または会議スペースの作成後に事前構成できます。この機能では、Google カレンダーから作成された会議の自動アーティファクトを設定することもできます。どちらのメソッドでも meetings.space.settings OAuth スコープが必要です。詳細については、設定の OAuth スコープをご覧ください。

自動アーティファクトを設定するには、SpaceConfig オブジェクトの下にある ArtifactConfig オブジェクトを使用します。ArtifactConfig は、recordingConfig、transcriptionConfig、smartNotesConfig の各フィールドで構成されています。

各フィールドは、RecordingConfig、TranscriptionConfig、SmartNotesConfig などの類似したオブジェクトにマッピングされます。各オブジェクトを設定するには、AutoGenerationType ブール値列挙型を使用して、構成オブジェクト on または off を切り替えます。

設定の OAuth スコープ

会議の設定またはアクセスには、次の OAuth スコープが必要です。

ユースケース スコープコード
他のアプリによって作成されたスペースの自動アーティファクト生成を設定します。 https://www.googleapis.com/auth/meetings.space.settings
他のアプリで作成された会議のアーティファクトを取得または一覧表示します。 https://www.googleapis.com/auth/meetings.space.readonly
サードパーティ製アプリで作成された会議スペースの会議前の他の設定を取得または一覧表示します。 https://www.googleapis.com/auth/meetings.space.created
https://www.googleapis.com/auth/meetings.space.readonly
ユーザーがカレンダーなどの他のアプリからアクセスできるすべての会議スペースの設定を読み取り、編集します。 https://www.googleapis.com/auth/meetings.space.settings

OAuth スコープの詳細については、Meet REST API scopes をご覧ください。

スペース メンバーを管理する

会議の主催者はいつでも参加リクエストなしで会議に参加できますが、参加リクエストなしで会議に参加できるメンバーを追加で設定することもできます。また、メンバーに会議でのロール（COHOST など）を割り当てて、会議の主催者と同じように会議を管理できるようにすることもできます。ノックせずに会議スペースにアクセスする方法について詳しくは、AccessType をご覧ください。

spaces.members リソースには、name、user、role の各フィールドが含まれます。

メンバーは参加者とは異なります。参加者とは、通話に参加しているユーザー、コンパニオン モードを使用しているユーザー、閲覧者として視聴しているユーザー、通話に接続されている会議室デバイスのことです。ユーザーごとに 1 つの conferenceRecords.participants リソースがあります。

Space メンバーは、次の方法で管理できます。

各メソッドはパスパラメータを受け取ります。作成メソッドとリストメソッドは parent フィールドを使用して会議スペースを指定し、削除メソッドと取得メソッドは name フィールドを使用して会議スペースとメンバー名に基づいて結果をフィルタします。

削除を除くすべてのメソッドは、SystemParameterContext の fields パラメータをサポートしています。fields パラメータを省略すると、API レスポンスはデフォルトで "name,email,role,user" になります。

fields パラメータは、レスポンスのフィルタリングに FieldMask を使用します。FieldMask は、API 呼び出し元がリクエストで返すフィールドを一覧表示する方法です。オブジェクト内の特定のフィールドのみを使用し、他のフィールドは変更しないように指定するフィールドのカンマ区切りリストです。FieldMask を使用すると、API は不要な作業を回避し、パフォーマンスを向上させることができます。フィールド マスクは、create、get、list の各メソッドで使用されます。フィールド マスクの詳細については、Google Sheets API のフィールド マスクを使用するをご覧ください。