Hướng dẫn này giải thích cách lấy thông tin chi tiết về các cấu phần phần mềm khác nhau của cuộc họp do một hội nghị tạo ra bằng cách sử dụng API REST của Google Meet.
Nội dung là một tệp hoặc dữ liệu do Google Meet tạo để phản hồi một hội nghị. Điều này bao gồm cả video và các thành phần khác, chẳng hạn như bản chép lời.
Để tạo dữ liệu, người tham gia phải tạo dữ liệu đó trong Meet trước khi hội nghị kết thúc. Bản chép lời hoạt động độc lập với bản ghi và bạn không cần ghi lại cuộc họp để tạo bản chép lời. Để biết thêm thông tin, hãy xem bài viết Ghi lại cuộc họp video và Sử dụng bản chép lời trong Google Meet.
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 recordings
, transcripts
và tài nguyên transcripts.entries
để truy xuất các cấu phần phần mềm.
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 ý.
Lưu giữ cấu phần phần mềm
Sau khi cuộc họp kết thúc, Meet sẽ lưu bản ghi và bản chép lời vào Google Drive của người tổ chức cuộc họp. Theo mặc định, các cấu phần phần mềm của Meet sẽ được giữ lại theo các quy tắc của Drive.
Các mục trong bản chép lời do Meet REST API cung cấp sẽ bị xoá 30 ngày sau khi hội nghị kết thúc.
Bạn cũng có thể quản lý việc lưu giữ dữ liệu từ Meet riêng biệt bằng cách sử dụng các quy tắc lưu giữ dành riêng cho Meet trong Google Vault. Để biết thêm thông tin, hãy xem bài viết Lưu giữ dữ liệu trên Google Meet bằng Vault.
Bản ghi âm
Các phần sau đây trình bày chi tiết cách lấy thông tin về bản ghi trong bản ghi hội nghị.
Meet có quyền truy cập vào mã bản ghi sau khi tệp bản ghi được tạo. Có thể người dùng sẽ xoá tệp ghi hình khỏi Google Drive, nhưng tên duy nhất vẫn được trả về trong Meet.
Tài nguyên recordings
bao gồm cả đối tượng DriveDestination
và State
.
Đối tượng DriveDestination
lưu giữ vị trí xuất trong Drive, nơi bản ghi được lưu dưới dạng tệp MP4. Để tải bản ghi xuống hoặc phát lại bản ghi trong trình duyệt, hãy sử dụng giá trị trường exportUri
của đối tượng. Nếu bạn đã quen thuộc với API Google Drive, thì giá trị trường file
sẽ tương ứng với id
trong tài nguyên files
. Để biết thêm thông tin, hãy xem bài viết Tải và xuất tệp.
Đối tượng State
lưu giữ trạng thái của phiên ghi hình. Điều này cho phép bạn truy vấn xem bản ghi đã bắt đầu hay chưa, bản ghi đã kết thúc nhưng tệp ghi chưa sẵn sàng hay tệp ghi đã được tạo và sẵn sàng tải xuống.
Xem thông tin chi tiết về bản ghi
Để biết thông tin chi tiết về một bản ghi cụ thể, hãy sử dụng phương thức get()
trên tài nguyên recordings
bằng tham số đường dẫn name
. Nếu không biết tên bản ghi, bạn có thể liệt kê tất cả tên bản ghi bằng phương thức list()
.
Phương thức này trả về một thực thể của tài nguyên recordings
.
Mẫu mã sau đây cho thấy cách truy xuất một bản ghi cụ thể:
Java
Node.js
Python
Thay thế tên bản ghi bằng tên của mã bản ghi cụ thể trong bản ghi hội nghị.
Liệt kê tất cả bản ghi
Để liệt kê thông tin chi tiết về tất cả bản ghi trong bản ghi hội nghị, hãy sử dụng phương thức list()
trên tài nguyên recordings
bằng tham số đường dẫn parent
. Định dạng:
conferenceRecords/{conferenceRecord}
.
Phương thức này trả về danh sách bản ghi hội nghị, được sắp xếp theo startTime
theo thứ tự tăng dần, dưới dạng một thực thể của tài nguyên recordings
. Để điều chỉnh kích thước trang, hãy xem phần Tuỳ chỉnh phân trang .
Mẫu mã sau đây cho biết cách liệt kê tất cả bản ghi 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ị.
Bản chép lời
Các phần sau đây trình bày chi tiết cách lấy thông tin về bản chép lời hội nghị trong bản ghi hội nghị.
Meet có quyền truy cập vào mã nhận dạng bản chép lời sau khi dữ liệu bản chép lời được tạo. Có thể người dùng sẽ xoá tệp bản chép lời khỏi Drive, nhưng tên duy nhất vẫn được trả về trong Meet.
Tài nguyên transcripts
bao gồm cả đối tượng DocsDestination
và State
.
Đối tượng DocsDestination
lưu giữ vị trí xuất trong Drive, nơi lưu tệp bản chép lời của Google Tài liệu. Để tìm nạp nội dung hoặc duyệt xem bản chép lời trong trình duyệt, hãy sử dụng giá trị trường exportUri
của đối tượng. Nếu bạn quen thuộc với API Google Tài liệu, thì giá trị trường document
sẽ tương ứng với documentId
trong tài nguyên documents
.
Đối tượng State
lưu giữ trạng thái của phiên chép lời. Điều này cho phép bạn truy vấn xem phiên chép lời đã bắt đầu hay chưa, phiên chép lời đã kết thúc nhưng tệp bản chép lời chưa sẵn sàng hay tệp bản chép lời đã được tạo và sẵn sàng tải xuống.
Xem thông tin chi tiết về bản chép lời
Để biết thông tin chi tiết về một bản chép lời cụ thể, hãy sử dụng phương thức get()
trên tài nguyên transcripts
bằng tham số đường dẫn name
. Nếu không biết tên bản chép lời, bạn có thể liệt kê tất cả tên bản chép lời bằng phương thức list()
.
Phương thức này trả về một thực thể của tài nguyên transcripts
.
Mẫu mã sau đây cho biết cách truy xuất một bản chép lời cụ thể:
Java
Node.js
Python
Thay thế tên bản chép lời bằng tên của mã nhận dạng bản chép lời cụ thể trong bản ghi hội nghị.
Liệt kê tất cả bản chép lời
Để liệt kê thông tin chi tiết về tất cả bản chép lời trong bản ghi hội nghị, hãy sử dụng phương thức list()
trên tài nguyên transcripts
bằng tham số đường dẫn parent
. Định dạng:
conferenceRecords/{conferenceRecord}
.
Phương thức này trả về một danh sách bản chép lời cuộc họp, được sắp xếp theo startTime
theo thứ tự tăng dần, dưới dạng một thực thể của tài nguyên transcripts
. Để điều chỉnh kích thước trang, hãy xem phần Tuỳ chỉnh phân trang .
Mẫu mã sau đây cho biết cách liệt kê tất cả bản chép lời trong 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ị.
Mục trong bản chép lời
Các phần sau đây trình bày chi tiết cách lấy lời nói của từng người tham gia dưới dạng các mục trong bản chép lời trong phiên chép lời hội nghị.
Mục bản chép lời chứa văn bản được chép lời từ giọng nói của người tham gia, tối đa 10.000 từ. Văn bản nói languageCode
(ví dụ: en-US
) cũng được đưa vào dưới dạng cú pháp IETF BCP 47.
Mỗi mục nhập bản chép lời được kết nối với một tên participant
trong hội nghị. Để truy xuất thông tin chi tiết về người tham gia, hãy xem phần Lấy thông tin chi tiết về người tham gia.
Dữ liệu về nội dung nhập trong bản chép lời sẽ có sẵn trong 30 ngày sau khi hội nghị kết thúc.
Xin lưu ý rằng các mục bản chép lời do Meet REST API trả về có thể không khớp với bản chép lời trong tệp bản chép lời của Tài liệu. Điều này xảy ra khi tệp bản chép lời được sửa đổi sau khi tạo.
Xem thông tin chi tiết về một mục trong bản chép lời
Để biết thông tin chi tiết về một mục phụ đề cụ thể, hãy sử dụng phương thức get()
trên tài nguyên transcripts.entries
bằng tham số đường dẫn name
. Nếu không biết tên mục phụ đề, bạn có thể liệt kê tất cả tên phụ đề bằng phương thức list()
.
Phương thức này trả về một thực thể của tài nguyên transcripts.entries
.
Mẫu mã sau đây cho biết cách truy xuất một mục nhập bản chép lời cụ thể:
Java
Node.js
Python
Thay thế tên mục nhập bản chép lời bằng tên của mã nhận dạng mục nhập bản chép lời cụ thể trong bản chép lời.
Liệt kê tất cả mục trong bản chép lời
Để liệt kê thông tin chi tiết về tất cả mục trong bản chép lời, hãy sử dụng phương thức list()
trên tài nguyên transcripts.entries
bằng tham số đường dẫn parent
. Định dạng:
conferenceRecords/{conferenceRecord}/transcripts/{transcript}
.
Phương thức này trả về một danh sách các mục bản chép lời có cấu trúc cho mỗi bản chép lời hội nghị, được sắp xếp theo startTime
theo thứ tự tăng dần, dưới dạng một thực thể của tài nguyên transcripts.entries
. Để điều chỉnh kích thước trang, hãy xem phần Tuỳ chỉnh phân trang .
Mã mẫu sau đây cho biết cách liệt kê tất cả các mục trong bản chép lời:
Java
Node.js
Python
Thay thế giá trị mẹ bằng tên của bản ghi hội nghị và tên bản chép lời.
Tuỳ chỉnh tính năng phân trang
Truyền các tham số truy vấn sau để tuỳ chỉnh việc phân trang bản ghi, bản chép lời và mục nhập bản chép lời:
pageSize
: Số lượng tối đa mặt hàng cần trả lại. Dịch vụ có thể trả về ít hơn giá trị này. Nếu không chỉ định, tối đa 10 mục sẽ được trả về. Giá trị tối đa là 100; các giá trị lớn hơn 100 sẽ tự động được thay đổi thành 100.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.
Chủ đề có liên quan
- Ghi lại cuộc họp video
- Dùng tính năng Bản chép lời trên Google Meet
- Lưu giữ dữ liệu trên Google Meet bằng Vault
- Tuỳ chỉnh các tính năng của Meet với vai trò quản trị viên