Tổng quan về API REST của Google Meet

API REST của Google Meet cho phép bạn tạo và quản lý các cuộc họp cho Google Meet, đồng thời cung cấp điểm truy cập cho người dùng ngay từ ứng dụng của bạn.

Với Meet REST API, bạn có thể làm những việc sau:

  • Tạo và định cấu hình không gian họp để kết nối người dùng qua video.
  • Định cấu hình trước các cấp độ truy cập vào không gian, chế độ cài đặt kiểm duyệt và bản ghi âm hoặc bản chép lời tự động.
  • Quản lý thành viên trong không gian họp và chỉ định vai trò người đồng tổ chức.
  • Kết thúc một hội nghị đang diễn ra theo cách lập trình trong không gian họp.
  • Nhận bản ghi hội nghị, thông tin chi tiết về việc tham dự và siêu dữ liệu về phiên của người tham gia.
  • Truy xuất dữ liệu cuộc họp (bản ghi, bản chép lời và mục trong bản chép lời).

Bạn cũng có thể đăng ký nhận thông báo về các sự kiện trên Meet bằng Google Workspace Events API. Để nhận thông báo về các thay đổi, bạn có thể đăng ký nhận thông báo về một không gian họp cụ thể hoặc tất cả không gian họp thuộc về một người dùng cụ thể. Để biết thêm thông tin, hãy xem các bài viết sau:

Trường hợp sử dụng

Các ứng dụng có thể tích hợp với Meet REST API để thực hiện các tác vụ sau:

  • Trước một hội nghị: Tạo không gian họp theo yêu cầu, định cấu hình trước các hạn chế về quyền truy cập (mở, đáng tin cậy hoặc hạn chế), áp dụng các chế độ kiểm soát hoạt động kiểm duyệt (chia sẻ màn hình, trò chuyện, thể hiện cảm xúc, micrô và camera), định cấu hình chế độ tự động ghi hình hoặc tự động chép lời và chỉ định vai trò người đồng tổ chức cho các thành viên trong không gian.

  • Trong một hội nghị: Truy xuất siêu dữ liệu hội nghị đang hoạt động và các phiên của người tham gia, quản lý thành viên một cách linh hoạt, theo dõi các sự kiện vòng đời theo thời gian thực bằng Google Workspace Events API hoặc kết thúc hội nghị đang hoạt động theo cách lập trình.

  • Sau hội nghị: Truy xuất bản ghi hội nghị và nhật ký điểm danh, tải bản ghi âm và bản chép lời trong Google Tài liệu xuống từ Google Drive, đồng thời truy cập vào các mục nhập lời nói chi tiết trong bản chép lời để huấn luyện, tuân thủ hoặc phân tích bằng AI.

Sau đây là một số ví dụ về những việc bạn có thể muốn sử dụng Meet REST API:

  • Bán hàng và quản lý tài khoản

    • Truy xuất thông tin về cuộc họp và người tham gia để lưu hồ sơ.
    • Tìm nạp dữ liệu cuộc họp và đăng trong tài khoản.
    • Chạy bản chép lời và bản ghi âm thông qua các mô hình AI để tạo nội dung huấn luyện và phân tích hiệu quả bán hàng.

  • Học tập và phát triển

    • Tạo và định cấu hình trước các cuộc họp để đào tạo.
    • Chỉ định vai trò người đồng tổ chức cho người hướng dẫn và người phụ trách phiên.
    • Lấy lại bản ghi để học viên có thể xem lại tài liệu sau khi khoá học kết thúc.

  • Hỗ trợ và tư vấn khách hàng

    • Tạo không gian họp an toàn, có giới hạn ngay từ phiếu yêu cầu trợ giúp hoặc cổng thông tin khách hàng.
    • Định cấu hình trước quyền quản lý của người tổ chức để chỉ nhân viên hỗ trợ mới có thể trình bày hoặc quản lý sự tham dự.
    • Bật tính năng tự động ghi âm hoặc chép lời để đảm bảo chất lượng và ghi lại thông tin tuân thủ.
    • Kết thúc các hội nghị đang diễn ra theo cách lập trình khi các cuộc hẹn hoặc phiên hỗ trợ kết thúc.

  • Hoạt động của nhà phát triển

    • Tạo cuộc họp để kết nối ngay lập tức với đồng nghiệp.
    • Cho phép các bên liên quan khác tham gia cuộc họp đang diễn ra bằng cách chia sẻ thông tin về cuộc họp và người tham gia theo thời gian thực.
    • Chạy dữ liệu phiên chép lời thông qua các mô hình AI để tạo ra các bước tiếp theo chính xác.
Tạo và tham gia một cuộc họp linh hoạt với đồng nghiệp trong một không gian trên Chat.
Hình 1. Tạo và tham gia một cuộc họp linh hoạt với đồng nghiệp trong một không gian trên Chat.

Bạn cũng có thể kết hợp các API khác của Google Workspace như Chat API vào ứng dụng của mình để nâng cao hơn nữa khả năng cộng tác. Để biết thêm thông tin, hãy xem Các trường hợp sử dụng tính năng trò chuyện.

Thuật ngữ thường gặp

Sau đây là danh sách các thuật ngữ thường dùng trong API này:

Hội nghị đang diễn ra
Hội nghị đang diễn ra trong một không gian họp. Tại một thời điểm bất kỳ, mỗi phòng họp chỉ có thể có một hội nghị truyền hình đang hoạt động. Sau khi kết thúc, bản ghi này sẽ trở thành một bản ghi hội nghị truyền hình.
Cấu phần phần mềm
Một tệp do Meet tạo để phản hồi một cuộc họp, chẳng hạn như recordings và transcripts. Dữ liệu được lưu vào Drive của người tổ chức cuộc họp. Các bản ghi này thường sẵn sàng được tìm nạp ngay sau khi một hội nghị kết thúc.
Sự kiện trên lịch
Một sự kiện trên Lịch Google có nhiều người tham dự, thường do người tổ chức cuộc họp tạo, chứa thông tin tham gia của một cuộc họp. Meet có thể là giải pháp hội nghị truyền hình cho sự kiện.
Gọi điện
Một phiên sử dụng Meet hoặc để thông báo cho người khác rằng một cuộc gọi đang bắt đầu hoặc đang diễn ra và cho phép họ tham gia ngay lập tức.
Người đồng tổ chức
Một người tham gia cuộc gọi và được người tổ chức cấp quyền quản lý của người tổ chức, ngoại trừ quyền xoá người tổ chức ban đầu.
Hội nghị
Hội nghị là một phiên bản của cuộc gọi trong không gian họp. Người dùng thường coi đây là một cuộc họp duy nhất.
Số lần hội ý
Mã nhận dạng duy nhất cho mỗi phiên bản của một hội nghị. Bản ghi này được tạo tự động khi hội nghị bắt đầu. Tài nguyên conferenceRecords sử dụng định dạng conferenceRecords/{conferenceRecord}. Ví dụ: conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ.
Gọi điện
Để sử dụng điện thoại tham gia cuộc gọi hoặc nghe cuộc gọi được phát trực tiếp.
Máy chủ lưu trữ
Người tạo cuộc gọi (người tổ chức cuộc họp) hoặc người kiểm soát cuộc gọi. Xin lưu ý rằng người tổ chức cuộc họp có thể tổ chức cuộc họp nhưng không tham dự khi cuộc họp diễn ra. Người tổ chức cũng có thể uỷ quyền tổ chức cho người đồng tổ chức.
Mã cuộc họp

Một chuỗi gồm 10 ký tự duy nhất mà người dùng có thể nhập cho một không gian họp được dùng trong URI cuộc họp của một không gian họp. Tham số này không phân biệt chữ hoa chữ thường. Ví dụ: abc-mnop-xyz Độ dài tối đa là 128 ký tự.

Bạn không nên lưu trữ mã cuộc họp trong thời gian dài vì mã này có thể bị tách khỏi một không gian họp và có thể được dùng lại cho các không gian họp khác trong tương lai. Thông thường, mã cuộc họp sẽ hết hạn sau 365 ngày kể từ lần sử dụng gần nhất. Để biết thêm thông tin, hãy xem bài viết Tìm hiểu về mã cuộc họp trong Google Meet.

Tên cuộc họp

Mã nhận dạng duy nhất do máy chủ tạo ra dùng để xác định một không gian họp. Tham số này phân biệt chữ hoa chữ thường. Ví dụ: jQCFfuBOdN5z. Mã nhận dạng cuộc họp được trả về trong trường name của tài nguyên spaces. Để biết thêm thông tin, hãy xem bài viết Cách Meet xác định không gian họp.

Người tổ chức cuộc họp

Người dùng đã tạo không gian trong cuộc họp. Người dùng này cũng có thể được coi là chủ sở hữu cuộc họp. Họ có thể không tham gia cuộc gọi hoặc không phải là người tổ chức cuộc họp. Mỗi cuộc họp chỉ được có một người tổ chức.

Không gian gặp gỡ

Một địa điểm ảo hoặc đối tượng cố định (chẳng hạn như phòng họp) nơi diễn ra hội nghị. Mỗi lần, bạn chỉ có thể tổ chức một hội nghị truyền hình đang hoạt động trong một không gian. Không gian tổ chức cuộc họp cũng giúp người dùng gặp gỡ và tìm thấy các tài nguyên dùng chung.

URI cuộc họp

Một URL có thể nhấp bắt đầu hoặc đưa người dùng vào một cuộc gọi. Mỗi cuộc gọi đều có một URL duy nhất bao gồm https://meet.google.com/, theo sau là mã cuộc họp. Ví dụ: https://meet.google.com/abc-mnop-xyz.

Thành viên

Người dùng được thêm rõ ràng vào một không gian họp với một vai trò được chỉ định (chẳng hạn như COHOST). Không giống như người tham gia chỉ xuất hiện trong một hội nghị trực tiếp, thành viên được liên kết với không gian họp cố định và giữ lại các đặc quyền của họ trong nhiều hội nghị trong không gian đó.

Người tham gia

Một người tham gia cuộc gọi hoặc sử dụng Chế độ đồng hành, xem ở chế độ người xem hoặc một 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. Khi một người tham gia tham gia hội nghị, hệ thống sẽ chỉ định một mã nhận dạng duy nhất.

Phiên của người tham gia

Mã phiên riêng biệt được tạo cho mỗi cặp thiết bị-người tham gia tham gia một cuộc gọi. Mỗi phiên đều 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 lần tham gia sẽ được chỉ định một mã phiên duy nhất.

Bản ghi

Tệp video MP4 và siêu dữ liệu liên kết được tạo khi một hội nghị được ghi lại. Các bản ghi được lưu vào Drive của người tổ chức cuộc họp và có thể được truy xuất dưới dạng dữ liệu cuộc họp.

Địa chỉ SIP

Giao thức thiết lập phiên (SIP) cho biết thông tin chi tiết về cách phần cứng hội nghị truyền hình của bên thứ ba có thể tìm và tham gia một hội nghị trên Meet. Meet hỗ trợ lược đồ URI SIP.

Bản chép lời

Một tài liệu văn bản ghi lại cuộc trò chuyện bằng lời nói trong một hội nghị, được xuất sang Drive của người tổ chức cuộc họp dưới dạng tệp Tài liệu.

Nhập bản chép lời

Một đoạn lời nói được chép lời riêng biệt của một người tham gia trong một hội nghị. Mỗi mục nhập bao gồm danh tính người tham gia, dấu thời gian, văn bản được nói và mã ngôn ngữ, đồng thời có sẵn trong 30 ngày sau khi hội nghị kết thúc.