このガイドでは、Google Meet REST API を使用して、過去の会議に参加した参加者またはアクティブな会議に参加している参加者の詳細とセッション情報を取得する方法について説明します。
参加者とは、通話に参加している人、コンパニオン
モードを使用している人、視聴者として視聴している人、または
通話に接続されている会議室デバイスを指します。参加者 1 人につき 1 つの
participants
リソースがあります。
参加者セッション
とは、通話に参加する参加者とデバイスのペアごとに作成される一意のセッション ID です。
セッションごとに 1 つの
participantSessions
リソースがあります。参加者が同じ参加者とデバイスのペアから同じ通話に複数回参加した場合、それぞれに一意のセッション ID が割り当てられます。
会議スペースの所有者または参加者は、participants リソースと participantSessions リソースの両方で get メソッドと list メソッドを呼び出して、参加者レコードを取得できます。
ユーザー 認証情報を使用して認証と承認を行うと、 Google Meet アプリはユーザーデータにアクセスし、認証された ユーザーに代わってオペレーションを実行できます。ドメイン全体の委任を使用して認証を行うと、アプリケーションのサービス アカウントによるユーザーのデータへのアクセスを承認できます。これにより、ユーザーごとに同意を求める必要がなくなります。
参加者
以降のセクションでは、会議レコードの参加者に関する情報を取得する方法について説明します。
participants
リソースは user フィールドと結合されます。user は次のいずれかのオブジェクトになります。
signedinUserは次のいずれかです。パソコン、モバイル デバイス、コンパニオン モードから参加している個人。
会議室デバイスで使用されるロボット アカウント。
anonymousUserは、Google アカウントにログインしていない未確認のユーザーです。A
phoneUserは、ユーザーの身元が不明な電話からダイヤルインしているユーザーです。 Google アカウントにログインしていないためです。
3 つのオブジェクトすべてで displayName が返されますが、signedinUser は Admin SDK API および People API と相互運用可能な一意の user ID も返します。形式: users/{user}。People API で user
ID を使用する方法について詳しくは、People API を使用して参加者の詳細を取得するをご覧ください。
参加者の詳細を取得する
特定の参加者の詳細を取得するには、
get
リソースで
participants
メソッドを使用します。name パスパラメータは、conferenceRecords/{conferenceRecord}/participants/{participantRecord} の形式で設定します。
参加者名がわからない場合は、すべての参加者
名を list メソッドを使用して一覧表示できます。
このメソッドは、参加者データを participants リソースのインスタンスとして返します。
次のコードサンプルは、特定の参加者を取得する方法を示しています。
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARTICIPANT_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN は、API へのアクセスを許可するアクセス トークンに置き換えます。
次のように置き換えます。
- 会議レコード名: 会議レコード内の特定の会議 ID の名前に置き換えます。
- 参加者名: 会議レコード内の特定の参加者 ID の名前に置き換えます。
すべての参加者を一覧表示する
会議レコード内のすべての参加者の詳細を一覧表示するには、
list
リソースで
participants
メソッドを使用します。parent パスパラメータは、conferenceRecords/{conferenceRecord} の形式で設定します。
このメソッドは、会議の参加者のリストを participants リソースのインスタンスとして返します。リストは earliestStartTime の降順で並べ替えられます。ページサイズを調整してクエリ結果をフィルタするには、ページ設定をカスタマイズするまたは参加者リストをフィルタするをご覧ください。
次のコードサンプルは、会議レコード内のすべての参加者を一覧表示する方法を示しています。
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/participants" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN は、API へのアクセスを許可するアクセス トークンに置き換えます。
親の名前は、会議レコード内の特定の会議 ID の名前に置き換えます。
ページ設定をカスタマイズするまたは参加者リストをフィルタする
次のクエリ パラメータを渡して、参加者のページ設定をカスタマイズするか、フィルタします。
pageSize: 返される参加者の最大数。この値よりも少ない数が返されることがあります。指定されていない場合、最大で 100 人の参加者が返されます。最大値は 250 です。250 を超える値は自動的に 250 に変更されます。pageToken: 前のリスト呼び出しから受信したページトークン。このトークンを指定すると、次のページを取得できます。filter: 省略可。participantsリソースの結果で特定のアイテムを取得するためのクエリ フィルタ。earliestStartTimeフィールドまたはlatestEndTimeフィールドを使用すると、特定の時刻より前に参加したユーザーまたは特定の時刻より後に退出したユーザーをフィルタできます。どちらのフィールドも、 [Timestamp] 形式をRFC 3339 UTC「Zulu」 形式で使用します。精度はナノ秒まで、小数点以下は最大 9 桁です:{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z。次に例を示します。earliestStartTime < 2023-10-01T15:01:23ZlatestEndTime < 2023-10-01T15:01:23Z
既存の会議のアクティブな参加者をすべて一覧表示するには、
latestEndTime IS NULLを使用します。
People API を使用して参加者の詳細を取得する
参加者の詳細を取得するには、People API の
people リソースで
get メソッドを使用します。
パスの末尾のコンポーネントを使用して、
participantリソースからユーザーの ID を抽出します。たとえば、participantリソース の値がconferenceRecords/abc-123/participants/12345の場合、 People API の ID は12345です。READ_SOURCE_TYPE_PROFILE、READ_SOURCE_TYPE_CONTACT、READ_SOURCE_TYPE_OTHER_CONTACTReadSourceTypeを含めます。これにより、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
次のように置き換えます。
- PERSON_ID: 検索するユーザーの ID。
- ACCESS_TOKEN: 複数の API へのアクセスを許可するアクセス トークン。
参加者セッション
以降のセクションでは、会議レコードの参加者の参加者セッションに関する情報を取得する方法について説明します。
参加者セッションの詳細を取得する
特定の参加者セッションの詳細を取得するには、
get
リソースで
participantSessions
メソッドを使用します。name パスパラメータは、conferenceRecords/{conferenceRecord}/participants/{participantRecord}/participantSessions/{participantSessionRecord} の形式で設定します。
参加者セッション名がわからない場合は、参加者のすべての参加者
セッションを list メソッドを使用して一覧表示できます。
このメソッドは、参加者名を participantSessions リソースのインスタンスとして返します。
次のコードサンプルは、特定の参加者セッションを取得する方法を示しています。
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARTICIPANT_NAME/participantSessions/PARTICIPANT_SESSION_ID" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN は、API へのアクセスを許可するアクセス トークンに置き換えます。
次のように置き換えます。
- 会議レコード名: 会議レコード内の特定の会議 ID の名前に置き換えます。
- 参加者名: 会議レコード内の特定の参加者 ID の名前に置き換えます。
- 参加者セッション ID: 特定の参加者セッションの ID に置き換えます。
すべての参加者セッションを一覧表示する
会議
レコードの参加者のすべての参加者セッションの詳細を一覧表示するには、
list()
メソッドを
participantSessions
リソースで使用します。parent パスパラメータは、conferenceRecords/{conferenceRecord}/participants/{participantRecord} の形式で設定します。
このメソッドは、参加者セッションのリストを participantSession リソースのインスタンスとして返します。リストは startTime の降順で並べ替えられます。ページサイズを調整してクエリ結果をフィルタするには、ページ設定をカスタマイズするまたは参加者セッション リストをフィルタするをご覧ください。
次のコードサンプルは、会議レコード内のすべての参加者セッションを一覧表示する方法を示しています。
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARENT_NAME/participantSessions" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN は、API へのアクセスを許可するアクセス トークンに置き換えます。
次のように置き換えます。
- 会議レコード名: 会議レコード内の特定の会議 ID の名前に置き換えます。
- 親の名前: 会議レコード内の参加者の参加者セッションの名前に置き換えます。
ページ設定をカスタマイズするまたは参加者セッション リストをフィルタする
次の省略可能なクエリ パラメータを渡して、参加者セッションのページ設定をカスタマイズするか、フィルタします。
pageSize: 返される参加者セッションの最大数。この値よりも少ない数が返されることがあります。指定されていない場合、最大で 100 個の参加者セッションが返されます。最大値は 250 です。250 を超える値は自動的に 250 に変更されます。pageToken: 前のリスト呼び出しから受信したページトークン。このトークンを指定すると、次のページを取得できます。filter: 省略可。participantsリソースの結果で特定のアイテムを取得するためのクエリ フィルタ。startTimeフィールドまたはendTimeフィールドを使用すると、特定の時刻より前に参加したユーザーまたは特定の時刻より後に退出したユーザーをフィルタできます。どちらのフィールドも、 [Timestamp] 形式をRFC 3339 UTC「Zulu」 形式で使用します。精度はナノ秒まで、小数点以下は最大 9 桁です:{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z。次に例を示します。startTime < 2023-10-01T15:01:23ZendTime < 2023-10-01T15:01:23Z
会議レコード内のアクティブな参加者セッションをすべて一覧表示するには、
endTime IS NULLを使用します。