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

Google Meet REST API cho phép bạn tạo và quản lý các cuộc họp trên 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 một không gian họp để kết nối người dùng qua video.
  • Lấy không gian họp hoặc hội nghị theo tên tài nguyên.
  • Lấy danh sách người tham gia và phiên của người tham gia.
  • Nhận dữ liệu từ 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 phần Đăng ký nhận sự kiện bằng Google Workspace Events API và Đăng ký nhận sự kiện trên Google Meet.

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 hội nghị: Điều chỉnh trải nghiệm hội nghị theo nhu cầu bằng cách tạo không gian họp. Bạn cũng có thể quản lý người được mời và định cấu hình trước các chế độ cài đặt.

  • Trong một hội nghị: Truy xuất thông tin về hội nghị để thay đổi trải nghiệm ứng dụng dựa trên siêu dữ liệu được trả về.

  • Sau hội nghị: Tìm nạp các cấu phần phần mềm của hội nghị, chẳng hạn như bản ghi và bản chép lời.

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 các cấu phần phần mềm của cuộc họp và đăng chú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 thông tin 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.

  • 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 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:

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. Thường thì bạn có thể tìm nạp một cấu phần phần mềm ngay sau khi 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.
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.
Người đồng tổ chức
Một người tham gia cuộc gọi đã đượ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.
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. Thông 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 không gian cuộc họp và có thể được dùng lại cho các không gian cuộc 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.

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

Người dùng đã tạo không gian 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 của cuộc họp

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 một 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 mời người dùng tham gia 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.

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 participants tài nguyên. 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 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.