Người tham gia là người đã tham gia cuộc gọi hoặc sử dụng Chế độ đồng hành, xem với tư cách người xem hoặc thiết bị phòng được kết nối với cuộc gọi. Mỗi người có một tài nguyên conferenceRecords.participants
.
Phiên của người tham gia là một mã phiên duy nhất được tạo cho mỗi cặp người tham gia-thiết bị tham gia cuộc gọi.
Mỗi phiên hoạt động có một tài nguyên conferenceRecords.participants.participantSessions
. Nếu người tham gia tham gia cùng một cuộc gọi nhiều lần từ cùng một cặp người tham gia-thiết bị, thì mỗi người tham gia sẽ được chỉ định mã phiên duy nhất.
Trang này mô tả cách lấy thông tin về tất cả người tham gia đã tham dự hoặc đang tham gia một hội nghị, hoặc chỉ về một người tham gia cùng với thông tin phiên của họ.
Người tham gia
Các phần sau đây trình bày chi tiết cách lấy thông tin về người tham gia.
Tài nguyên conferenceRecords.participants
bao gồm trường user
. user
chỉ có thể là một trong các đối tượng sau:
signedinUser
là:Một cá nhân tham gia bằng máy tính cá nhân, thiết bị di động hoặc thông qua Chế độ đồng hành.
Tài khoản rô bốt mà các thiết bị trong phòng họp sử dụng.
anonymousUser
là một người dùng chưa xác định và chưa đăng nhập vào Tài khoản Google.phoneUser
là người dùng gọi điện từ một chiếc điện thoại mà danh tính của người dùng không xác định được vì họ chưa đăng nhập bằng Tài khoản Google.
Tìm kiếm tất cả người tham gia
Để biết thông tin chi tiết về tất cả người tham gia trong bản ghi hội nghị, hãy sử dụng phương thức list()
trên tài nguyên conferenceRecords.participants
với tham số đường dẫn parent
.
Bạn có thể sử dụng trường earliestStartTime
hoặc latestEndTime
để lọc những người dùng đã tham gia trước hoặc rời đi sau một khoảng thời gian nhất định. Cả hai trường đều sử dụng định dạng Dấu thời gian theo định dạng "Zulu" RFC 3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số thập phân: {year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
. Ví dụ:
earliestStartTime < 2023-10-01T15:01:23Z
latestEndTime < 2023-10-01T15:01:23Z
Để nhận người tham gia tích cực trong một cuộc họp hiện có, hãy sử dụng latestEndTime IS
NULL
.
Phương thức này trả về danh sách người tham gia hội nghị, được sắp xếp theo thứ tự thời gian tham gia giảm dần, dưới dạng một thực thể của tài nguyên conferenceRecords.participants
.
Mã mẫu sau đây cho biết cách liệt kê tất cả người tham gia trong bản ghi cuộc họp:
Java
Node.js
Python
Thay thế giá trị gốc bằng tên của bản ghi hội nghị.
Tìm một người tham gia cụ thể
Để tìm kiếm một người tham gia cụ thể, hãy sử dụng phương thức get()
trên tài nguyên conferenceRecords.participants
với tham số đường dẫn name
. Để truy xuất tên của người tham gia, hãy sử dụng phương thức conferenceRecords.participants.list
.
Phương thức này trả về tên người tham gia dưới dạng một thực thể của tài nguyên conferenceRecords.participants
.
Mã mẫu sau đây cho biết cách truy xuất một người tham gia cụ thể:
Java
Node.js
Python
Thay thế tên người tham gia bằng tên của người tham gia cụ thể mà bạn muốn tìm.
Phiên của người tham gia
Các phần sau đây trình bày chi tiết cách lấy thông tin về phiên của người tham gia.
Tìm kiếm tất cả phiên hoạt động của người tham gia
Để biết thông tin chi tiết về tất cả phiên tham gia của một người tham gia trong bản ghi hội nghị, hãy sử dụng phương thức list()
trên tài nguyên conferenceRecords.participants.participantSessions
với tham số đường dẫn parent
.
Bạn có thể sử dụng trường startTime
hoặc endTime
để lọc những người dùng đã tham gia trước hoặc rời đi sau một khoảng thời gian nhất định. Cả hai trường đều sử dụng định dạng Dấu thời gian theo định dạng "Zulu" RFC 3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số thập phân: {year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
. Ví dụ:
startTime < 2023-10-01T15:01:23Z
endTime < 2023-10-01T15:01:23Z
Phương thức này trả về danh sách các phiên của người tham gia, được sắp xếp theo thứ tự thời gian tham gia giảm dần, dưới dạng một thực thể của tài nguyên conferenceRecords.participants.participantSession
.
Mẫu mã sau đây cho biết cách liệt kê tất cả các phiên của người tham gia trong bản ghi hội nghị:
Java
Node.js
Python
Thay thế giá trị gốc bằng tên bản ghi hội nghị và tên người tham gia.
Tìm một phiên của người tham gia cụ thể
Để tìm một phiên tham gia cụ thể, hãy sử dụng phương thức get()
trên tài nguyên conferenceRecords.participants.participantSessions
với tham số đường dẫn name
. Để truy xuất tên của người tham gia, hãy sử dụng phương thức list()
.
Phương thức này trả về tên người tham gia dưới dạng một thực thể của tài nguyên conferenceRecords.participants.participantSessions
.
Mẫu mã sau đây cho thấy cách truy xuất một phiên người tham gia cụ thể:
Java
Node.js
Python
Thay thế tên người tham gia bằng tên của người tham gia cụ thể mà bạn muốn tìm.
Truy xuất thông tin chi tiết về người tham gia bằng API People
Để truy xuất thông tin chi tiết về một người tham gia, hãy sử dụng phương thức people.get
trong People API.
- Trích xuất mã nhận dạng của người đó từ tên tài nguyên của người tham gia bằng cách sử dụng thành phần theo sau của đường dẫn. Ví dụ: nếu tên tài nguyên của người tham gia là
conferenceRecords/abc-123/participants/12345
, thì mã nhận dạng cho People API là12345
. - Bao gồm các nguồn
READ_SOURCE_TYPE_PROFILE
,READ_SOURCE_TYPE_CONTACT
vàREAD_SOURCE_TYPE_OTHER_CONTACT
. Điều này đảm bảo cả người dùng nội bộ của một tổ chức Google Workspace và người liên hệ bên ngoài đều được đưa vào phản hồi.
Ví dụ sau đây tìm kiếm cả hồ sơ tổ chức và danh bạ của một người:
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