会議スペースは、会議が開催される仮想的な場所または永続的なオブジェクト（会議室など）を表します。会議スペースは、ユーザーが会議を開いたり、共有リソースを見つけたりするのにも役立ちます。
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.createdhttps://www.googleapis.com/auth/meetings.space.readonly |
| ユーザーが他のアプリ（カレンダーなど）からアクセスできるすべての会議スペースの設定を読み取り、編集します。 | https://www.googleapis.com/auth/meetings.space.settings |
OAuth スコープの詳細については、REST API スコープについてをご覧ください。
スペースのメンバーを管理する
会議の主催者はいつでも参加をリクエストせずに会議に参加できますが、参加をリクエストせずに会議に参加できる追加のメンバーを設定することもできます。また、会議でロール（COHOST など）を持つようにメンバーを構成することもできます。これにより、会議の主催者と同じように会議を管理できるようになります。ノックせずに会議スペースにアクセスする方法について詳しくは、AccessType をご覧ください。
spaces.members リソースには、name、user、role フィールドが含まれます。
メンバーは参加者とは異なります。参加者は、通話に参加しているユーザー、コンパニオン モードを使用しているユーザー、閲覧者として視聴しているユーザー、通話に接続されているルーム デバイスです。1 人あたり 1 つの conferenceRecords.participants リソースがあります。
スペースのメンバーは、次の方法で管理できます。
各メソッドは、作成メソッドとリストメソッドで parent フィールドを使用して会議スペースを指定します。また、削除メソッドと取得メソッドで name フィールドを使用して、会議スペースとメンバー名に基づいて結果をフィルタします。
削除を除くすべてのメソッドは、SystemParameterContext の fields パラメータをサポートしています。fields パラメータを省略すると、API レスポンスはデフォルトで "name,email,role,user" になります。
fields パラメータは、レスポンスのフィルタリングに FieldMask を使用します。FieldMask は、API 呼び出し元がリクエストから返されるフィールドを一覧表示する方法です。カンマ区切りのフィールドのリストです。オブジェクト内の特定のフィールドのみを使用し、他のフィールドは変更しないことを指定します。FieldMask を使用すると、API で不要な処理を回避し、パフォーマンスを向上させることができます。フィールドマスクは、create、get、list の各メソッドで使用されます。フィールド マスクの詳細については、Google スプレッドシート API のフィールド マスクを使用するをご覧ください。