Hướng dẫn này giải thích cách lấy thông tin chi tiết về những người tham gia đã tham dự một hội nghị truyền hình trước đây hoặc đang tham gia một hội nghị truyền hình đang diễn ra, cùng với thông tin về phiên của họ, bằng cách sử dụng Google Meet REST API.
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 là người xem hoặc là một thiết bị phòng họp được kết nối với cuộc gọi. Mỗi người có một participants
tài nguyên.
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 có một tài nguyên 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 lần tham gia sẽ được chỉ định một mã phiên duy nhất.
Nếu là chủ sở hữu hoặc người tham gia không gian họp, bạn có thể gọi các phương thức get()
và list()
trên cả tài nguyên participants
và participantSessions
để truy xuất bản ghi của người tham gia.
Việc xác thực và uỷ quyền bằng thông tin đăng nhập của người dùng cho phép các ứng dụng Google Meet truy cập vào dữ liệu người dùng và thực hiện các thao tác thay mặt cho người dùng đã xác thực. Xác thực bằng tính năng uỷ quyền trên toàn miền cho phép bạn uỷ quyền cho tài khoản dịch vụ của một ứng dụng truy cập vào dữ liệu của người dùng mà không yêu cầu mỗi người dùng phải đồng ý.
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 trong bản ghi hội nghị.
Các liên kết tài nguyên participants
với trường user
. user
chỉ có thể là một trong những đối tượng sau:
signedinUser
có thể 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 rô bốt được các thiết bị trong phòng hội nghị truyền hình sử dụng.
anonymousUser
là 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ừ đ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.
Xin lưu ý rằng mặc dù cả 3 đối tượng đều trả về một displayName
, nhưng signedinUser
cũng trả về một mã nhận dạng user
duy nhất có thể tương tác với Admin SDK API và People API. Định dạng: users/{user}
. Để biết thêm thông tin về cách sử dụng mã nhận dạng user
với People API, hãy xem bài viết Truy xuất thông tin chi tiết về người tham gia bằng People API.
Xem thông tin chi tiết về người tham gia
Để biết thông tin chi tiết về một người tham gia cụ thể, hãy sử dụng phương thức get()
trên tài nguyên participants
bằng tham số đường dẫn name
. Nếu không biết tên người tham gia, bạn có thể liệt kê tất cả tên người tham gia bằng phương thức list()
.
Phương thức này trả về dữ liệu người tham gia dưới dạng một thực thể của tài nguyên participants
.
Mẫu mã 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 mã nhận dạng người tham gia cụ thể trong bản ghi hội nghị.
Liệt kê tất cả người tham gia
Để liệt kê 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 participants
bằng tham số đường dẫn parent
. Định dạng:
conferenceRecords/{conferenceRecord}
.
Phương thức này trả về danh sách những người tham gia hội nghị, được sắp xếp theo earliestStartTime
theo thứ tự giảm dần, dưới dạng một thực thể của tài nguyên participants
. Để điều chỉnh kích thước trang và lọc kết quả truy vấn, hãy xem phần Tuỳ chỉnh phân trang hoặc lọc danh sách người tham gia.
Mẫu mã 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ị:
Java
Node.js
Python
Thay thế giá trị mẹ bằng tên của bản ghi hội nghị.
Tuỳ chỉnh việc phân trang hoặc lọc danh sách người tham gia
Truyền các tham số truy vấn sau để tuỳ chỉnh việc phân trang hoặc lọc người tham gia:
pageSize
: Số lượng người tham gia tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu bạn không chỉ định, hệ thống sẽ trả về tối đa 100 người tham gia. Giá trị tối đa là 250; các giá trị lớn hơn 250 sẽ tự động thay đổi thành 250.pageToken
: Mã thông báo trang, nhận được từ một lệnh gọi danh sách trước đó. Cung cấp mã thông báo này để truy xuất trang tiếp theo.filter
: Không bắt buộc. Một bộ lọc truy vấn để truy xuất các mục cụ thể trong kết quả tài nguyênparticipants
.Bạn có thể sử dụng trường
earliestStartTime
hoặclatestEndTime
để lọc những 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 đị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
Để liệt kê tất cả những người tham gia đang hoạt động trong một hội nghị hiện có, hãy sử dụng
latestEndTime IS NULL
.
Truy xuất thông tin chi tiết về người tham gia bằng People API
Để 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 get()
trên tài nguyên people
trong People API.
Trích xuất mã nhận dạng của người dùng từ tài nguyên
participant
bằng thành phần cuối cùng của đường dẫn. Ví dụ: nếu giá trị tài nguyênparticipant
làconferenceRecords/abc-123/participants/12345
thì mã nhận dạng cho People API là12345
.Bao gồm
READ_SOURCE_TYPE_PROFILE
,READ_SOURCE_TYPE_CONTACT
vàREAD_SOURCE_TYPE_OTHER_CONTACT
ReadSourceType
. Đ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ó trong phản hồi.
Mẫu mã sau đây cho biết cách 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
Thay thế nội dung sau:
- PERSON_ID: mã nhận dạng của người cần tìm.
- ACCESS_TOKEN: mã thông báo truy cập cấp quyền truy cập vào nhiều API.
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ề các phiên của người tham gia trong bản ghi hội nghị.
Xem thông tin chi tiết về phiên của người tham gia
Để biết thông tin chi tiết về một phiên của người tham gia cụ thể, hãy sử dụng phương thức get()
trên tài nguyên participantSessions
bằng tham số đường dẫn name
. Nếu không biết tên phiên của người tham gia, bạn có thể liệt kê tất cả các phiên của người tham gia bằ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 participantSessions
.
Mẫu mã sau đây cho thấy 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 mã nhận dạng phiên cụ thể của người tham gia trong một phiên của người tham gia.
Liệt kê tất cả các phiên của người tham gia
Để liệt kê thông tin chi tiết về tất cả các phiên của 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 participantSessions
bằng tham số đường dẫn parent
. Định dạng:
conferenceRecords/{conferenceRecord}/participants/{participant}
.
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 startTime
theo thứ tự giảm dần, dưới dạng một thực thể của tài nguyên participantSession
. Để điều chỉnh kích thước trang và lọc kết quả truy vấn, hãy xem phần Tuỳ chỉnh phân trang hoặc lọc danh sách phiên của người tham gia.
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 một bản ghi hội nghị:
Java
Node.js
Python
Thay thế giá trị mẹ bằng tên của các phiên tham gia của một người tham gia trong bản ghi hội nghị.
Tuỳ chỉnh việc phân trang hoặc lọc danh sách phiên của người tham gia
Truyền các tham số truy vấn không bắt buộc sau đây để tuỳ chỉnh việc phân trang hoặc lọc các phiên của người tham gia:
pageSize
: Số lượng phiên tối đa của người tham gia cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu không được chỉ định, tối đa 100 phiên của người tham gia sẽ được trả về. Giá trị tối đa là 250; các giá trị lớn hơn 250 sẽ tự động thay đổi thành 250.pageToken
: Mã thông báo trang, nhận được từ một lệnh gọi danh sách trước đó. Cung cấp mã thông báo này để truy xuất trang tiếp theo.filter
: Không bắt buộc. Một bộ lọc truy vấn để truy xuất các mục cụ thể trong kết quả tài nguyênparticipants
.Bạn có thể sử dụng các trường
startTime
hoặcendTime
để lọc những 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 đị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
Để liệt kê tất cả các phiên hoạt động của người tham gia trong bản ghi hội nghị, hãy sử dụng
endTime IS NULL
.