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

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

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

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

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

`SpaceConfig` オブジェクトを使用して、ユーザーが会議に参加する方法、管理モード、機能制限、会議への参加時にユーザーに付与される権限を設定できます。SpaceConfig

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

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

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

会議スペースを管理する

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

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

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

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

出席レポートを生成する

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

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

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

自動アーティファクトは、会議スペースの作成時または会議スペースの作成後に事前に設定できます。どちらの方法でも、meetings.space.settings OAuth スコープが必要です。詳細については、設定の OAuth スコープをご覧ください。

Google カレンダーから作成された会議の自動アーティファクトを設定することもできます。

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

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

会議中に作成されたアーティファクトを取得するには、アーティファクトを操作するをご覧ください。

文字起こしとスマートメモの違い

会議の文字起こしとスマートメモ（「自動メモ生成」とも呼ばれます）はどちらも会議から情報をキャプチャしますが、これらの機能は目的が異なり、生成されるアーティファクトも異なります。

次の表に、これらの違いを示します。

機能	文字起こし	スマートメモ
概要	逐語的な記録。	Gemini によって生成された要点の簡潔な要約。
詳細レベル	100% の詳細。発言された内容はすべて書き留められます。	概要。決定事項とアクションアイテムに焦点を当てます。
ユースケース	法令遵守、正確な引用の確認、ユーザー補助。	遅れて参加した参加者がすぐに追いつけるようにする。議事録の作成とプロジェクトのトラッキングを自動化する。
リアルタイムでの使用	字幕に使用されます。ファイルは通話後に生成されます。	通話中にサイドパネルで要約の作成状況を確認できます。
出力	話者の名前とタイムスタンプを含む長い Google ドキュメント。	セクションと箇条書きを含む会議メモの簡潔な Google ドキュメント。
引用	リンク可能な全文が含まれています。	文字起こしとスマートメモの両方が有効になっている場合は、コンテキストの文字起こしの特定の瞬間にリンクする引用（タイムスタンプ）が含まれます。詳細については、両方の機能が有効になっている場合をご覧ください。

両方の機能が有効になっている場合

各機能は個別に使用できますが、文字起こしとスマートメモの両方を同時に使用して、会議後のアーティファクトを改善することもできます。

両方が有効になっている場合、生成されたスマートメモドキュメントに引用が表示されます。これらの引用は詳細セクション全体に表示され、会議の文字起こしの特定のタイムスタンプにリンクされています。引用をクリックすることで、文字起こしの該当するセクションに直接移動して、ディスカッションについての理解を深めることができます。

会議中、参加者には両方の機能が有効になっていることを示すインジケーターが表示されます。クリック可能な引用を生成するには、会議中ずっと有効にしておく必要があります。ファイルは相互にリンクされていますが、ホストの Google ドライブには 2 つの異なるドキュメントが生成されます。両方のファイルは、Google カレンダーの予定にも自動的に添付されます。

設定の 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 スコープをご覧ください。

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

スペースメンバーは、会議スペースでロールを持つように構成されたユーザーです。これらのユーザーは、接続権限をリクエスト（「参加リクエスト」とも呼ばれます）しなくても会議スペースに参加できます。

会議の主催者は会議スペースに自動的に参加できますが、参加リクエストなしで会議に参加できるように追加のメンバーを構成することもできます。また、メンバーは会議で Role を持つように構成できます。たとえば、COHOST を指定すると、会議の主催者と同じように会議を管理できます。参加リクエストなしで会議スペースにアクセスする方法について詳しくは、 AccessTypeをご覧ください。

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

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

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

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

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

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