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 trên Google Meet cũng như cung cấp điểm truy cập cho người dùng ngay từ ứng dụng của bạn.

Với API REST của Meet, 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.
  • Xem không gian tổ chức cuộc họp hoặc hội nghị theo tên tài nguyên.
  • Nhận danh sách người tham gia và các phiên của người tham gia.
  • Lấy nội dung cuộc họp (bản ghi, bản chép lời và mục nhập trong 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ý không gian họp cụ thể hoặc cho tất cả không gian họp thuộc về một người dùng được chỉ định. Để biết thêm thông tin, hãy xem phần Đăng ký sự kiện bằng Google Workspace Event API và tính năng Đăng ký Google Meet sự kiện.

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

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

  • Trước hội nghị: Điều chỉnh trải nghiệm hội nghị nếu cần bằng cách tạo không gian hội họp. Bạn cũng có thể quản lý khách mời và định cấu hình trước phần cài đặt.

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

  • Sau hội nghị: Tìm nạp nội dung hội nghị, chẳng hạn như bản ghi và chép lời.

Một số ví dụ về những việc bạn nên sử dụng API REST của Meet bao gồm sau:

  • Quản lý bán hàng và tài khoản

    • Truy xuất thông tin người tham gia và cuộc họp cho mục đích ghi lại.
    • Tìm nạp nội dung cuộc họp rồi đăng vào tài khoản.
    • Chạy bản chép lời và bản ghi 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à thiết lập trước các cuộc họp để đào tạo.
    • Chỉ định vai trò người đồng tổ chức cho chuyên viên đào tạo và trưởng nhóm phiên trình bày.
    • Truy xuất các bản ghi để học viên có thể xem lại tài liệu sau 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 các thành viên trong nhóm ngay lập tức.
    • Cho phép các bên liên quan khác tham gia các cuộc họp đang diễn ra bằng cách chia sẻ theo thời gian thực thông tin về cuộc họp và người tham gia.
    • Chạy dữ liệu bản chép lời thông qua các mô hình AI để tạo chính xác bước.
Tạo và tham gia một cuộc họp động với đồng nghiệp trong phòng Chat.
Hình 1. Tạo và tham gia một cuộc họp động với đồ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, chẳng hạn như API Chat vào ứng dụng của mình để cộng tác hiệu quả hơn nữa. Để biết thêm thông tin, hãy xem 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 sử dụng trong API này:

Artifact
Một tệp do Meet tạo để phản hồi một hội nghị, chẳng hạn như bản ghi và bản chép lời. Thông thường, 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 một người tổ chức cuộc họp, chứa thông tin về cách 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 một cuộc gọi bắt đầu hoặc đang diễn ra và cho phép họ tham gia ngay lập tức.
Hội nghị truyền hình
Hội nghị truyền hình là một phiên bản của một cuộc gọi trong một không gian họp. Người dùng thường coi tình huống này là một cuộc gặp gỡ.
Người đồng tổ chức
Một người trong cuộc gọi đã được máy chủ lưu trữ, ngoại trừ khả năng loại bỏ máy chủ lưu trữ 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 điều khiển cuộc gọi đó. Xin lưu ý rằng người tổ chức cuộc họp có thể sắp xếp cuộc họp nhưng không xuất hiện khi nó diễn ra. Máy chủ lưu trữ cũng có thể uỷ quyền cho máy chủ lưu trữ đặc quyền cho một người đồng tổ chức.
Mã cuộc họp

Một chuỗi gồm 10 ký tự duy nhất, có thể đánh máy cho một không gian họp được dùng trong phần tử URI cuộc họp của một không gian họp. Mã 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ì chúng có thể bị tách rời từ một không gian họp và có thể được tái sử dụng cho các không gian họp khác nhau 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 hãy xem phần 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 dùng để xác định một không gian họp. Đó là trường hợp nhạy cảm. 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 xem xét chủ sở hữu cuộc họp. Họ có thể không xuất hiện trong cuộc gọi hoặc là người tổ chức cuộc họp. Chỉ được có một người tổ chức cuộc họp.

Không gian hội họp

Một địa điểm ảo hoặc vật thể cố định (chẳng hạn như phòng họp) có hội nghị truyền hình. Bạn chỉ có thể tổ chức một hội nghị đang hoạt động tại một không gian tại bất cứ lúc nào. Không gian họp cũng giúp người dùng gặp gỡ và tìm 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 tham gia cùng người dùng vào một cuộc 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à 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 tính năng Đồng hành , đang xem như hoặc một thiết bị trong phòng kết nối với một cuộc gọi. Có một conferenceRecords.participants tài nguyên cho mỗi người. Khi người tham gia tham gia hội nghị, đã chỉ định mã nhận dạng duy nhất.

Phiên họp người tham gia

Một mã phiên duy nhất được tạo cho mỗi cặp thiết bị của người tham gia tham gia gọi. Có một conferenceRecords.participants.participantSessions cho mỗi phiên hoạt động. Nếu người tham gia tham gia cùng một cuộc gọi số lần từ cùng một cặp thiết bị của người tham gia, mỗi người sẽ được chỉ định ID phiên.