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