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

API Google Meet REST 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 các điểm truy cập cho người dùng ngay trong ứng dụng của bạn.

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

  • Tạo không gian họp để kết nối người dùng qua video.
  • Lấy phòng họp hoặc cuộc họp theo tên tài nguyên.
  • Nhận danh sách người tham gia và phiên của người tham gia.
  • Nhận cấu phần phần mềm của cuộc họp (bản ghi, bản chép lời và mục bản chép lời).

Bạn cũng có thể đăng ký các sự kiện trên Meet bằng API Sự kiện của Google Workspace. Để nhận thông báo về các thay đổi, bạn có thể đăng ký 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 bài viết Đăng ký sự kiện bằng API Sự kiện của Google Workspace và Đăng ký 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 API Meet REST để 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 phòng họp. Bạn cũng có thể quản lý khách mời và định cấu hình trước các chế độ cài đặt.

  • Trong hội nghị: Truy xuất thông tin 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 API Meet REST:

  • 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 cho mục đích ghi lại.
    • Tìm nạp cấu phần phần mềm của cuộc họp và đăng các cấu phần phần mềm đó 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 bản phân tích hiệu quả bán hàng và hướng dẫn.

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

    • Tạo và định cấu hình trước cuộc họp để đào tạo.
    • Chỉ định vai trò người đồng tổ chức cho các chuyên gia đào tạo và người phụ trách phiên.
    • Truy xuất bản ghi để học viên 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 tức thì với các thành viên trong nhóm.
    • 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 bả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 cuộc họp linh động với các đồng nghiệp trong phòng Chat.
Hình 1. Tạo và tham gia cuộc họp linh động với các đồng nghiệp trong phòng 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 bài viết Các trường hợp sử dụng Chat.

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

Sau đây là danh sách các thuật ngữ phổ biến được dùng trong API này:

Cấu phần phần mềm
Tệp do Meet tạo ra để phản hồi một hội nghị, chẳng hạn như bản ghi âm và bản chép lời. Thông thường, một cấu phần phần mềm sẽ sẵn sàng được tìm nạp ngay sau khi hội nghị kết thúc.
Sự kiện trên lịch
Một sự kiện trong 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ị cho sự kiện này.
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 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 thực thể của lượt gọi trong không gian họp. Người dùng thường coi trường hợp này là một cuộc họp.
Đồng tổ chức
Một người trong cuộc gọi đã được người tổ chức cấp đặc quyền quản lý 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 cần phải có mặt khi cuộc họp diễn ra. Người tổ chức cũng có thể uỷ quyền các đặc quyền của người tổ chức cho người đồng tổ chức.
Mã cuộc họp

Chuỗi 10 ký tự duy nhất, có thể nhập được cho một không gian họp được dùng trong URI cuộc họp của không gian họp. 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 sử dụng lại cho nhiều 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 phòng họp. Mã này phân biệt chữ hoa chữ thường. Ví dụ: jQCFfuBOdN5z. Mã 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 có mặt trong cuộc gọi hoặc không phải là người tổ chức cuộc họp. Chỉ có thể có một người tổ chức cuộc họp.

Không gian họp

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

URI cuộc họp

URL có thể nhấp để bắt đầu hoặc tham gia một lượt gọi. Mỗi cuộc gọi 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 với tư cách là người xem hoặc 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 conferenceRecords.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 duy nhất được tạo cho mỗi cặp người tham gia-thiết bị tham gia một lệnh gọi. Mỗi phiên hoạt động có một tài nguyên conferenceRecords.participants.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 người tham gia sẽ được chỉ định một mã phiên duy nhất.