Để sử dụng Google Meet Media API và các phạm vi OAuth 2.0 được liên kết với API này, ứng dụng của bạn phải tuân thủ các yêu cầu sau.
Yêu cầu về kỹ thuật
Các điều kiện ràng buộc sau đây được thực thi khi làm việc với Meet Media API:
Ứng dụng phải hỗ trợ tất cả các bộ mã hoá/giải mã sau:
AV1VP9VP8
Ứng dụng phải sử dụng các lượt triển khai bộ mã hoá/giải mã tuân thủ các yêu cầu về bộ mã hoá/giải mã của Meet Media API, bao gồm:
libvpx(Google) để giải mãVP8hoặcVP9dav1d(VideoLAN) để giải mãAV1
Ứng dụng phải hỗ trợ các tiện ích tiêu đề WebRTC sau:
- Thời gian gửi tuyệt đối
- Kiểm soát tình trạng tắc nghẽn trên toàn bộ quá trình truyền tải
- Thời gian chụp tuyệt đối
- Mô tả phần phụ thuộc
- Chỉ báo mức âm thanh
(
urn:ietf:params:rtp-hdrext:ssrc-audio-level)
Ứng dụng phải định kỳ gửi một bộ chỉ số đầy đủ. Để biết thêm thông tin, hãy xem trang chỉ số của ứng dụng để biết thông tin chi tiết.
Để có kết quả và sự hỗ trợ tốt nhất:
Ứng dụng nên sử dụng thư viện
libwebrtcvà phiên bản này không được cũ hơn 12 tháng so với bản phát hành ChromiumSTABLEmới nhất. Trình duyệt Chromium sử dụnglibwebrtcđể triển khai các API JavaScript WebRTC.Ứng dụng nên duy trì băng thông tối thiểu là 4 Mbps.
Bật Meet API REST
Trước khi sử dụng API của Google, bạn cần bật các API đó trong một dự án trên Google Cloud. Bạn có thể bật một hoặc nhiều API trong một dự án trên Google Cloud.Trong bảng điều khiển Cloud, hãy bật Google Meet API REST.
Chính sách về việc ngừng cung cấp bộ mã hoá/giải mã
Google giữ quyền ngừng sử dụng một bộ mã hoá/giải mã bất cứ lúc nào.
Khi một bộ mã hoá/giải mã mới được giới thiệu, nhà phát triển sẽ nhận được thông báo trước 12 tháng trước khi ứng dụng bắt buộc phải hỗ trợ bộ mã hoá/giải mã này.
Xác thực và uỷ quyền
Ứng dụng Google Meet Media API kết nối với một hội nghị thay mặt cho một người dùng cụ thể, sử dụng OAuth 2.0 để xác thực và uỷ quyền.
Quyền truy cập thích hợp
Phạm vi của Meet Media API
Phạm vi uỷ quyền là những quyền mà bạn yêu cầu người dùng uỷ quyền cho ứng dụng của bạn để truy cập vào nội dung cuộc họp. Khi ai đó cài đặt ứng dụng của bạn, người dùng sẽ được yêu cầu xác thực các phạm vi này. Thông thường, bạn nên chọn phạm vi tập trung hẹp nhất có thể và tránh yêu cầu các phạm vi mà ứng dụng của bạn không cần. Người dùng sẵn sàng cấp quyền truy cập vào các phạm vi có giới hạn và được mô tả rõ ràng hơn.
Meet Media API hỗ trợ phạm vi OAuth 2.0 sau đây:
| Mã phạm vi | Mô tả | Cách sử dụng |
|---|---|---|
https://www.googleapis.com/auth/meetings.conference.media.readonly |
Quay video và ghi âm theo thời gian thực trong các cuộc gọi video trên Google Meet. | Bị hạn chế |
https://www.googleapis.com/auth/meetings.conference.media.audio.readonly |
Ghi âm theo thời gian thực trong các cuộc gọi video trên Google Meet. | Bị hạn chế |
https://www.googleapis.com/auth/meetings.conference.media.video.readonly |
Quay video theo thời gian thực trong các cuộc gọi video trên Google Meet. | Bị hạn chế |
Do tính chất nhạy cảm của các hội nghị, tất cả phạm vi của Meet Media API đều bị hạn chế:
- Bị hạn chế: Các phạm vi này cung cấp quyền truy cập rộng rãi vào dữ liệu người dùng của Google và yêu cầu bạn phải trải qua quy trình xác minh phạm vi bị hạn chế. Để biết thông tin về yêu cầu này, hãy xem Chính sách dữ liệu người dùng của các dịch vụ API của Google và Các yêu cầu bổ sung đối với các phạm vi API cụ thể. Nếu bạn lưu trữ dữ liệu phạm vi bị hạn chế trên máy chủ (hoặc truyền dữ liệu), thì bạn phải trải qua một quy trình đánh giá bảo mật.
Ngoài các phạm vi của Meet Media API, bạn cũng phải yêu cầu phạm vi đọc chung của cuộc họp bằng OAuth. Bạn cần có phạm vi này để truy cập vào siêu dữ liệu cuộc họp, chẳng hạn như thông tin về người tham gia và mục nội dung nghe nhìn, cũng như để thương lượng kết nối thành công.
| Mã phạm vi | Mô tả | Cách sử dụng |
|---|---|---|
https://www.googleapis.com/auth/meetings.space.read |
Cho phép ứng dụng đọc siêu dữ liệu về mọi không gian cuộc họp mà người dùng có quyền truy cập. | Nhạy cảm |
Nếu ứng dụng của bạn yêu cầu quyền truy cập vào bất kỳ API nào khác của Google, bạn cũng có thể thêm các phạm vi đó. Để biết thêm thông tin về các phạm vi API của Google, hãy xem bài viết Sử dụng OAuth 2.0 để truy cập vào các API của Google.
Để xác định thông tin nào được hiển thị cho người dùng và người đánh giá ứng dụng, hãy xem bài viết Định cấu hình màn hình xin phép bằng OAuth và chọn phạm vi.
Để biết thêm thông tin về các phạm vi OAuth 2.0 cụ thể, hãy xem bài viết Phạm vi OAuth 2.0 cho các API của Google.
Yêu cầu đối với người dùng cuối
Để sử dụng Meet Media API, người tham gia Meet cũng phải đáp ứng một số yêu cầu tối thiểu để hội nghị đủ điều kiện.
Phiên bản ứng dụng di động
Đối với người dùng thiết bị di động, họ phải cập nhật lên các phiên bản sau:
| Nền tảng | Ứng dụng | Phiên bản |
|---|---|---|
| Android | Ứng dụng Meet | 309 |
| iOS | Ứng dụng Meet | 308 |
| Android | Ứng dụng Gmail | 2025.05.30 |
| iOS | Ứng dụng Gmail | 6.0.250518 |
Nền tảng không được hỗ trợ
Chúng tôi không hỗ trợ các ứng dụng phần cứng của bên thứ ba chạy Meet. Ví dụ: nếu người dùng cuối đang sử dụng thiết bị phòng hội nghị phần cứng của Cisco chạy Meet, thì thực thể Meet Media API của bạn không thể tham gia cuộc gọi.
Giới hạn độ tuổi
Meet Media API bị hạn chế thu thập nội dung nghe nhìn từ các tài khoản được đăng ký cho trẻ vị thành niên.
Đây thường là những tài khoản dưới độ tuổi hợp pháp để tự quản lý tài khoản ở quốc gia tương ứng (thường là dưới 18 tuổi) hoặc dưới độ tuổi hợp pháp để tự quản lý tài khoản khi tài khoản được cha mẹ tạo trong ứng dụng Google Family Link.
Xin lưu ý rằng một số khu vực (chẳng hạn như Liên minh Châu Âu) có các quy định hạn chế bổ sung về loại tài khoản được coi là dưới độ tuổi.
Nếu bạn cho rằng một trong các tài khoản của người dùng bị hạn chế, bạn có thể cung cấp xác minh tuổi để kiểm tra xem tài khoản của họ đã được xác minh tuổi hay chưa. Tìm hiểu thêm về cách xác minh tuổi của bạn.