参加者とは、通話に参加しているユーザー、コンパニオン モードを使用しているユーザー、閲覧者として視聴しているユーザー、通話に接続されている会議室デバイスのことです。1 人あたり 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
参加者名は、検索する特定の参加者の名前に置き換えます。
People API を使用して参加者の詳細を取得する
参加者の詳細を取得するには、People API の people.get
メソッドを使用します。
- パスの末尾のコンポーネントを使用して、参加者リソース名からユーザーの ID を抽出します。たとえば、参加者リソース名が
conferenceRecords/abc-123/participants/12345
の場合、People API の ID は12345
です。 - ソース
READ_SOURCE_TYPE_PROFILE
、READ_SOURCE_TYPE_CONTACT
、READ_SOURCE_TYPE_OTHER_CONTACT
を含めます。これにより、Google Workspace 組織の内部ユーザーと外部連絡先の両方がレスポンスに含まれます。
次の例では、組織のプロフィールと連絡先の両方でユーザーを検索します。
cURL
curl \
'https://people.googleapis.com/v1/people/PERSON_ID?personFields=names%2CemailAddresses&sources=READ_SOURCE_TYPE_OTHER_CONTACT&sources=READ_SOURCE_TYPE_PROFILE&sources=READ_SOURCE_TYPE_CONTACT' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--header 'Accept: application/json' \
--compressed