Hướng dẫn này giải thích cách tìm thông tin chi tiết về những người tham gia đã tham dự một hội nghị trước đây hoặc đang tham gia một hội nghị đang diễn ra, cùng với thông tin về phiên của họ, bằng cách sử dụng API REST của Google Meet.
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
thiết bị trong phòng được kết nối với cuộc gọi. Mỗi người sẽ có một
participants
tài nguyên.
Phiên 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 sẽ có một
participantSessions
tài nguyên. 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 gán 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. Việc xác thực bằng cơ chế 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 cần 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 tìm thông tin về người tham gia trong bản ghi hội nghị.
Tài nguyên
participants
kết hợp với trường user. user chỉ có thể là một trong các đối tượng sau:
A
signedinUserlà: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.
Một tài khoản robot do các thiết bị trong phòng hội nghị sử dụng.
An
anonymousUserlà một người dùng không xác định, chưa đăng nhập vào Tài khoản Google.A
phoneUserlà người dùng gọi điện từ mộ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ả ba đối tượng đều trả về displayName, nhưng signedinUser cũng trả về một mã nhận dạng user duy nhất có khả năng 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 user
ID 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.
Tìm thông tin chi tiết về người tham gia
Để tìm thông tin chi tiết về một người tham gia cụ thể, hãy sử dụng phương thức trên tài nguyên.getparticipants Đặt tham số đường dẫn name bằng định dạng conferenceRecords/{conferenceRecord}/participants/{participantRecord}.
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 thực thể của tài nguyên 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
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARTICIPANT_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
Thay thế ACCESS_TOKEN bằng mã truy cập cấp quyền truy cập vào API.
Thay thế nội dung sau:
- Tên bản ghi hội nghị bằng tên của mã hội nghị truyền hình cụ thể trong bản ghi hội nghị.
- Tên người tham gia bằng tên của mã 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 bản ghi hội nghị, hãy sử dụng
list
phương thức trên
participants
tài nguyên. Đặt tham số đường dẫn parent bằng định dạng conferenceRecords/{conferenceRecord}.
Phương thức này trả về danh sách 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 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 bài viết Tuỳ chỉnh
phân trang hoặc lọc danh sách người tham gia.
Mã mẫu sau đây cho biết cách liệt kê tất cả người tham gia trong bản ghi hội nghị:
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/participants" \
-H "Authorization: Bearer ACCESS_TOKEN"
Thay thế ACCESS_TOKEN bằng mã truy cập cấp quyền truy cập vào API.
Thay thế tên mẹ bằng tên của mã hội nghị truyền hình cụ thể trong bản ghi hội nghị.
Tuỳ chỉnh phân trang hoặc lọc danh sách người tham gia
Truyền các tham số truy vấn sau đây để tuỳ chỉnh phân trang hoặc lọc người tham gia:
pageSize: Số 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 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 được thay đổi thành 250.pageToken: Mã thông báo trang, nhận được 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. 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
earliestStartTimehoặ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 ở định dạng "Zulu" UTC RFC 3339, 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:23ZlatestEndTime < 2023-10-01T15:01:23Z
Để liệt kê tất cả 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ề 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 đó từ tài nguyên
participantbằng cách sử dụng thành phần cuối cùng của đường dẫn. Ví dụ: nếu giá trị tài nguyênparticipantlàconferenceRecords/abc-123/participants/12345thì mã nhận dạng cho People API là12345.Bao gồm
READ_SOURCE_TYPE_PROFILE,READ_SOURCE_TYPE_CONTACTvàREAD_SOURCE_TYPE_OTHER_CONTACTReadSourceType. Điều này đảm bảo rằng cả người dùng nội bộ của tổ chức Google Workspace và người liên hệ bên ngoài đều được đưa vào phản hồi.
Mã mẫu 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ã 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 tìm thông tin về phiên của người tham gia trong bản ghi hội nghị.
Tìm thông tin chi tiết về phiên của người tham gia
Để tìm 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. Đặt tham số đường dẫn name bằng định dạng conferenceRecords/{conferenceRecord}/participants/{participantRecord}/participantSessions/{participantSessionRecord}.
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ả 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 thực thể của tài nguyên participantSessions.
Mẫu mã sau đây cho biết cách truy xuất một phiên của người tham gia cụ thể:
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"
Thay thế ACCESS_TOKEN bằng mã truy cập cấp quyền truy cập vào API.
Thay thế nội dung sau:
- Tên bản ghi hội nghị bằng tên của mã hội nghị truyền hình cụ thể trong bản ghi hội nghị.
- Tên người tham gia bằng tên của mã người tham gia cụ thể trong bản ghi hội nghị.
- Mã phiên của người tham gia bằng mã của phiên người tham gia cụ thể.
Liệt kê tất cả phiên của người tham gia
Để liệt kê thông tin chi tiết về tất 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. Đặt tham số đường dẫn parent bằng định dạng conferenceRecords/{conferenceRecord}/participants/{participantRecord}.
Phương thức này trả về danh sách 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 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 bài viết Tuỳ chỉnh phân trang hoặc lọc
danh sách phiên của người tham gia.
Mã mẫu sau đây cho biết cách liệt kê tất cả phiên của người tham gia trong bản ghi hội nghị:
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"
Thay thế ACCESS_TOKEN bằng mã truy cập cấp quyền truy cập vào API.
Thay thế nội dung sau:
- Tên bản ghi hội nghị bằng tên của mã hội nghị truyền hình cụ thể trong bản ghi hội nghị.
- Tên mẹ bằng tên của phiên người tham gia của một người tham gia trong bản ghi hội nghị.
Tuỳ chỉnh 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 phân trang hoặc lọc phiên của người tham gia:
pageSize: Số phiên của 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 không chỉ định, hệ thống sẽ trả về tối đa 100 phiên của người tham gia. Giá trị tối đa là 250; các giá trị lớn hơn 250 sẽ tự động được thay đổi thành 250.pageToken: Mã thông báo trang, nhận được 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. 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
startTimehoặ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 ở định dạng "Zulu" UTC RFC 3339, 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:23ZendTime < 2023-10-01T15:01:23Z
Để liệt kê tất cả phiên của người tham gia đang hoạt động trong bản ghi hội nghị, hãy sử dụng
endTime IS NULL.