参加者とは、通話に参加するユーザー、またはコンパニオン モードを使用しているユーザー、閲覧者として視聴しているユーザー、通話に接続されたルーム デバイスのいずれかです。ユーザーごとに 1 つの conferenceRecords.participants
リソースがあります。
参加者セッションは、通話に参加する参加者とデバイスのペアごとに作成される一意のセッション ID です。セッションごとに 1 つの conferenceRecords.participants.participantSessions
リソースがあります。同じ参加者とデバイスのペアから同じ通話に複数回参加した参加者には、一意のセッション ID が割り当てられます。
このページでは、会議に参加したすべての参加者に関する情報、または 1 人の参加者に関する情報と、セッション情報を取得する方法について説明します。
出場選手
以下のセクションでは、参加者に関する情報を取得する方法について説明します。
conferenceRecords.participants
リソースには user
フィールドが含まれています。user
は、次のオブジェクトのいずれかになります。
signedinUser
は次のいずれかです。パソコン、モバイル デバイス、またはコンパニオン モードから参加している個人。
会議室デバイスで使用されるロボット アカウント。
anonymousUser
は、Google アカウントにログインしていない未確認のユーザーです。phoneUser
は、Google アカウントでログインしていないため、ユーザーの ID が不明なスマートフォンからダイヤルインするユーザーです。
全参加者を検索
会議レコード内のすべての参加者の詳細を取得するには、parent
パスパラメータを指定して conferenceRecords.participants
リソースの list()
メソッドを使用します。
earliestStartTime
フィールドまたは latestEndTime
フィールドを使用して、特定の時間よりも前に参加したユーザーまたは離脱したユーザーをフィルタできます。どちらのフィールドも、RFC 3339 UTC「Zulu」形式のタイムスタンプ形式を使用します。分解能はナノ秒単位で、小数点以下 9 桁までです({year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
)。次に例を示します。
earliestStartTime < 2023-10-01T15:01:23Z
latestEndTime < 2023-10-01T15:01:23Z
既存の会議のアクティブな参加者を取得するには、latestEndTime IS
NULL
を使用します。
このメソッドは、会議参加者のリストを、参加時間の降順で conferenceRecords.participants
リソースのインスタンスとして返します。
次のコードサンプルは、会議レコード内のすべての参加者を一覧表示する方法を示しています。
Java
Node.js
Python
親値を会議レコードの名前に置き換えます。
特定の参加者を検索する
特定の参加者を検索するには、name
パスパラメータを指定して conferenceRecords.participants
リソースの get()
メソッドを使用します。参加者の名前を取得するには、conferenceRecords.participants.list
メソッドを使用します。
このメソッドは、参加者名を conferenceRecords.participants
リソースのインスタンスとして返します。
次のコードサンプルは、特定の参加者を取得する方法を示しています。
Java
Node.js
Python
参加者の名前を、検索する特定の参加者の名前に置き換えます。
参加者セッション
以下のセクションでは、参加者セッションに関する情報を取得する方法について説明します。
すべての参加者セッションを検索
会議レコード内の参加者のすべての参加者セッションの詳細を取得するには、parent
パスパラメータを指定して、conferenceRecords.participants.participantSessions
リソースの list()
メソッドを使用します。
startTime
フィールドまたは endTime
フィールドを使用して、特定の時間より前または後に参加したユーザーをフィルタリングできます。どちらのフィールドも、RFC 3339 UTC「Zulu」形式のタイムスタンプ形式を使用します。分解能はナノ秒単位で、小数点以下 9 桁までです({year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
)。次に例を示します。
startTime < 2023-10-01T15:01:23Z
endTime < 2023-10-01T15:01:23Z
このメソッドは、参加時間の降順で並べ替えられた参加者セッションのリストを conferenceRecords.participants.participantSession
リソースのインスタンスとして返します。
次のコードサンプルは、会議レコード内のすべての参加者セッションを一覧表示する方法を示しています。
Java
Node.js
Python
親の値を、会議レコードの名前と参加者名に置き換えます。
特定の参加者セッションを検索する
特定の参加者セッションを検索するには、name
パスパラメータを指定して conferenceRecords.participants.participantSessions
リソースの get()
メソッドを使用します。参加者の名前を取得するには、list()
メソッドを使用します。
このメソッドは、参加者名を conferenceRecords.participants.participantSessions
リソースのインスタンスとして返します。
次のコードサンプルは、特定の参加者セッションを取得する方法を示しています。
Java
Node.js
Python
参加者の名前を、検索する特定の参加者の名前に置き換えます。