Để sử dụng Google Meet Media API và các phạm vi OAuth liên kết, ứ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 sẽ được thực thi khi bạn làm việc với Meet Media API:
Ứng dụng phải hỗ trợ tất cả các bộ mã hoá và giải mã sau:
AV1
VP9
VP8
Các ứng dụng phải sử dụng các phương thức triển khai bộ mã hoá và giải mã tuân thủ các yêu cầu về bộ mã hoá và giải mã của Meet Media API, bao gồm:
libvpx
(Google) để giải mãVP8
hoặcVP9
dav1d
(VideoLAN) để giải mãAV1
Các ứ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ắc nghẽn trên toàn bộ lớp 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
)
Các ứ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à dịch vụ hỗ trợ tốt nhất:
Các ứng dụng nên sử dụng thư viện
libwebrtc
và phiên bản nên không được cũ hơn 12 tháng so với bản phát hành ChromiumSTABLE
mới nhất. Các trình duyệt Chromium sử dụnglibwebrtc
để triển khai API WebRTC JavaScript.Khách hàng nên duy trì băng thông tối thiểu là 4 Mb/giây.
Bật Meet REST API
Trước khi sử dụng API của Google, bạn cần bật các API đó trong một dự án Google Cloud. Bạn có thể bật một hoặc nhiều API trong một dự án Google Cloud.Trong Google Cloud Console, hãy bật Google Meet REST API.
Chính sách về việc ngừng cung cấp bộ mã hoá và giải mã
Google giữ quyền ngừng sử dụng một bộ mã hoá và giải mã bất cứ lúc nào.
Khi một bộ mã hoá và giải mã mới ra mắt, nhà phát triển sẽ nhận được thông báo trước 12 tháng trước khi các ứng dụng bắt buộc phải hỗ trợ bộ mã hoá và giải mã này.
Xác thực và uỷ quyền
Các ứng dụng Google Meet Media API kết nối với một hội nghị thay cho một người dùng cụ thể, bằng cách sử dụng OAuth 2.0 để xác thực và uỷ quyền.
Quyền truy cập phù hợp
Phạm vi API nội dung nghe nhìn của Meet
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 để ứng dụng của bạn có thể truy cập vào nội dung cuộc họp. Khi có người 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. Nhìn chung, 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 những 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 hạn chế và được mô tả rõ ràng.
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 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 trên 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 phạm vi API cụ thể. Nếu lưu trữ dữ liệu thuộc 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 quy trình đánh giá bảo mật.
Nếu ứng dụng của bạn cần có 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 hiển thị cho người dùng và người đánh giá ứng dụng, hãy xem phần Định cấu hình màn hình đồ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 Phạm vi OAuth 2.0 cho các API của Google.