会議スペースは、会議が開催される仮想の場所または永続オブジェクト(会議室など)を表します。会議スペースは、ユーザーが会議を開いたり、共有リソースを見つけたりするのにも役立ちます。
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
リソースには、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 Sheets API のフィールド マスクを使用するをご覧ください。