Người tham gia là người đã tham gia một cuộc gọi hoặc sử dụng Chế độ đồng hành, xem với tư cách là người xem hoặc một thiết bị trong phòng đã kết nối với cuộc gọi. Có một tài nguyên conferenceRecords.participants
cho mỗi người.
Phiên của người tham gia là 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 tài nguyên 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, 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ả những người tham gia đã tham dự hoặc đang tham gia một hội nghị hoặc về chỉ một người tham gia, 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 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 từ 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 robot được các thiết bị trong phòng hội nghị sử dụng.
anonymousUser
là người dùng không 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ừ đ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 một 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 các trường earliestStartTime
hoặc latestEndTime
để lọc tìm những người dùng đã tham gia trước hoặc đã rời khỏi sau một khoảng thời gian nhất định. Cả hai trường đều sử dụng định dạng Timestamp (Dấu thời gian) ở định dạng UTC "Zulu" RFC 3339, với độ phân giải nano giây và tối đa 9 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
Để mời người tham gia đang hoạt động trong một hội nghị truyền hình hiện có, hãy sử dụng latestEndTime IS
NULL
.
Phương thức này sẽ trả về một danh sách những người tham gia hội nghị, được sắp xếp theo 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 một bản ghi 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.
Tìm 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
bằng 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 sẽ trả về tên người tham gia dưới dạng 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ể đó để tìm.
Phiên có sự tham gia 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ề các phiên của người tham gia.
Tìm kiếm tất cả phiên của người tham gia
Để biết thông tin chi tiết về tất cả phiên người 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 các trường startTime
hoặc endTime
để lọc những người dùng đã tham gia trước hoặc đã rời khỏi sau một khoảng thời gian nhất định. Cả hai trường đều sử dụng định dạng Timestamp (Dấu thời gian) ở định dạng "Zulu" RFC 3339 (UTC), với độ phân giải nano giây và tối đa chín 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 trả về một danh sách các phiên của người tham gia, được sắp xếp theo 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ã 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 bản ghi hội nghị:
Java
Node.js
Python
Thay thế giá trị gốc bằng tên của bản ghi hội nghị và tên người tham gia.
Tìm kiếm phiên của người tham gia cụ thể
Để tìm kiếm một phiên hoạt động cụ thể của người tham gia, 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 sẽ trả về tên người tham gia dưới dạng thực thể 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 hoạt động 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ể đó để tìm.