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

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

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

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

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

新しいベータ版オブジェクトを使用すると、モデレーション モード、機能の制限、ユーザーが会議に参加する際に付与される権限を設定できるようになりました。これらは、更新された SpaceConfig オブジェクトで設定します。

moderation フィールドは、会議の事前構成済みモデレーション モードです。デフォルトはユーザーのポリシーによって制御されます。Moderation オブジェクトを使用します。管理モードがオンの場合、会議オーナーは、共同ホストの管理(spaces.members を参照)や機能の制限(moderationRestrictions を参照)などの機能を使用して会議を管理できます。メンバーの詳細については、Space のメンバーを管理するをご覧ください。

moderation がオンの場合、moderationRestrictions フィールドは会議のモデレーション制限を適用します。ModerationRestrictions オブジェクトを使用します。制限では、チャット メッセージやリアクションの送信、画面の共有の権限を持つユーザーを定義し、ユーザーに割り当てられるデフォルトのロールを閲覧者に制限するかどうかを指定します。moderationRestrictions フィールドは、最初の 3 つの制限を適用するために RestrictionType に依存します。RestrictionType は、会議のオーナーと共同主催者、またはすべての参加者に適用できます。DefaultJoinAsViewerType は、ユーザーがデフォルトで作成者として参加する最終的な権限を適用しますが、ホストはユーザーが視聴者として参加することを制限することもできます。

firstJoinerType フィールドは、この会議スペースの会議でユーザーが主催者より先に会議に参加できるかどうかを設定します。どのユーザーが最初に会議に参加できるか、他のユーザーが待機状態になるかどうかを定義します。FirstJoinerType オブジェクトを使用します。

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

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

spaces.members リソースには、nameuserrole フィールドが含まれます。

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

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

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

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

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