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 cuộc họp trước đó hoặc đang tham gia một cuộc họp đang diễn ra, cùng với thông tin phiên của họ, bằng cách sử dụng API Google Meet REST.
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 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 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.
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 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 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 ứ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 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.
Xin lưu ý rằng mặc dù cả ba đố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 API SDK quản trị và API People. Đị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 API People, hãy xem phần Truy xuất thông tin chi tiết về người tham gia bằng API People.
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
với 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ã 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 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 bản ghi hội nghị, hãy sử dụng phương thức list()
trên tài nguyên participants
với tham số đường dẫn parent
. Đị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 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ã 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ị.
Tuỳ chỉnh tính năng 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 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 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 được 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. 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 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" 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:23Z
latestEndTime < 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ề một người tham gia, hãy sử dụng phương thức get()
trên tài nguyên people
trong API People.
Trích xuất mã nhận dạng của người đó từ tài nguyên
participant
bằng cách sử dụng thành phần theo sau 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 API People 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 tổ chức Google Workspace và người liên hệ bên ngoài đều có trong 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ã 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ề phiên tham gia của một 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 tham gia cụ thể, hãy sử dụng phương thức get()
trên tài nguyên participantSessions
với tham số đường dẫn name
. Nếu không biết tên phiên tham gia, bạn có thể liệt kê tất cả phiên tham gia của một 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 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ã phiên người tham gia cụ thể trong phiên người tham gia.
Liệt kê tất cả phiên hoạt động của người tham gia
Để liệt kê 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 participantSessions
với tham số đường dẫn parent
. Định dạng: conferenceRecords/{conferenceRecord}/participants/{participant}
.
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 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 tính năng 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 bản ghi hội nghị:
Java
Node.js
Python
Thay thế giá trị gốc bằng tên của phiên tham gia của một người tham gia trong bản ghi hội nghị.
Tuỳ chỉnh tính năng 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 các phiên của người tham gia:
pageSize
: Số phiên người tham gia tối đa sẽ được 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 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. 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 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" 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:23Z
endTime < 2023-10-01T15:01:23Z
Để liệt kê tất cả các phiên người tham gia đang hoạt động trong bản ghi hội nghị, hãy sử dụng
endTime IS NULL
.