Tổng quan về không gian họp trên Google Meet

Hình minh hoạ về API REST của Google Meet

Hướng dẫn này giải thích cách Google Meet REST API giúp bạn tạo và quản lý các cuộc họp cho Google Meet.

Không gian hội họp đại diện cho một địa điểm ảo hoặc một đối tượng cố định (chẳng hạn như phòng họp) nơi tổ chức các 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 hội 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.

Để làm việc với không gian họp, hãy xem bài viết Tạo và quản lý không gian họp. Để tìm hiểu cách định cấu hình không gian họp theo phương thức lập trình, hãy xem phần Định cấu hình không gian họp và thành viên.

Cách gọi các phương thức của không gian họp

Bảng sau đây trình bày chi tiết về các vai trò trong cuộc họp cần thiết để sử dụng các phương thức của không gian họp:

Phương thức Chủ sở hữu Người tham gia Khác
endActiveConference x
get x x x
     có chế độ cài đặt x
     với hội nghị truyền hình đang diễn ra x x
patch x

Cách Meet xác định không gian của cuộc họp

Google Meet REST API tạo một tài nguyên spaces cho mỗi không gian họp. Tài nguyên spaces cung cấp nhiều điểm truy cập để tham gia một hội nghị.

Bảng sau đây cho biết cách xác định và tham gia một không gian họp:

Tên trường Mô tả
name Tên của không gian. Chuỗi {space} là giá trị nhận dạng tài nguyên cho khoảng trống và được định dạng là spaces/{space}. Đây là một mã nhận dạng duy nhất do máy chủ tạo và phân biệt chữ hoa chữ thường. Ví dụ: spaces/jQCFfuBOdN5z.
meetingCode Bí danh cho tên không gian. {meetingCode} là một chuỗi ký tự duy nhất có thể nhập và không phân biệt chữ hoa chữ thường. Tệp này có định dạng là spaces/{meetingCode}. Ví dụ: spaces/abc-mnop-xyz. Độ dài tối đa là 128 ký tự. Đây là một phần của meetingUri: https://meet.google.com/abc-mnop-xyz.
phoneAccess Các phương thức truy cập qua điện thoại cho không gian họp này. Đối tượng phoneAccess chứa thông tin cần thiết để quay số vào một hội nghị, bao gồm cả số điện thoại theo khu vực cho không gian họp và mã PIN dành riêng cho số điện thoại đó. Mã PIN chỉ chứa các chữ số thập phân và độ dài có thể thay đổi. Ví dụ: "pin": 19707127300

Tương tự như giao diện người dùng Meet, tài nguyên spaces bao gồm một số lượng hạn chế các số điện thoại truy cập. Bạn có thể xem thêm số điện thoại cho một không gian họp bằng cách thêm {meetingCode} vào URL sau: https://meet.google.com/tel/. Ví dụ: https://meet.google.com/tel/abc-mnop-xyz
gatewaySipAccess Các phương thức truy cập Giao thức khởi tạo phiên (SIP) cho không gian họp này. Địa chỉ SIP cho biết 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. Đối tượng gatewaySipAccess chứa một URI và mã truy cập bằng số. Meet hỗ trợ giản đồ URI SIP.

Để quản lý không gian họp, hãy dùng các giá trị sau cho trường name:

  • Để biết thông tin chi tiết về một không gian họp, bạn có thể sử dụng spaces/{space} hoặc biệt hiệu spaces/{meetingCode}. Để biết thêm thông tin, hãy xem bài viết Nhận không gian họp.

  • Để cập nhật thông tin chi tiết của một không gian họp, bạn chỉ có thể dùng spaces/{space}. Để biết thêm thông tin, hãy xem bài viết Cập nhật không gian họp.

  • Để kết thúc một hội nghị truyền hình đang diễn ra trong không gian họp, bạn chỉ có thể dùng spaces/{space}. Để biết thêm thông tin, hãy xem phần Kết thúc hội nghị đang diễn ra.

Vòng đời của không gian tổ chức cuộc họp

Không gian họp trải qua một số trạng thái trong vòng đời của nó. Sơ đồ sau đây cho thấy các bước cấp cao trong vòng đời của không gian họp:

Vòng đời của không gian tổ chức cuộc họp.
Hình 1. Vòng đời của không gian tổ chức hội nghị.

  1. Gọi điện thoại spaces.create. Không gian họp được tạo và đối tượng spaces được trả về chứa chuỗi meetingUri. Sau đó, meetingUri sẽ được gửi cho những người tham gia.

  2. Tạo cuộc thăm dò ý kiến về không gian họp mới. Gọi phương thức spaces.get để kiểm tra trạng thái hội nghị.

    Thay vì thăm dò ý kiến, bạn cũng có thể đăng ký nhận thông báo về sự kiện trên Meet để nhận thông báo đẩy.

  3. Bắt đầu hội nghị. Khi người tham gia đầu tiên nhấp vào biểu tượng meetingUri trong không gian họp, một hội nghị sẽ bắt đầu. Đối tượng activeConference được điền sẵn và chuỗi activeConference.conferenceRecord được thiết lập.

  4. (Không bắt buộc) Lấy dữ liệu hội nghị. Trong một hội nghị đang diễn ra, bạn có thể truy cập vào một số giá trị conferenceRecord. Ví dụ: gọi phương thức conferenceRecords.participants.list để xem tất cả người tham gia trong hội nghị. Bạn cũng có thể truy cập vào thông tin này trong tối đa 30 ngày sau hội nghị.

  5. (Không bắt buộc) Kết thúc hội nghị truyền hình. Trong hội nghị, chủ sở hữu cuộc họp có thể gọi phương thức spaces.endActiveConference để kết thúc hội nghị đang diễn ra đối với tất cả người tham gia theo cách lập trình.

  6. Hội nghị kết thúc. Khi người tham gia cuối cùng rời đi, hội nghị sẽ kết thúc.

  7. Bình chọn cho các dữ liệu sau hội nghị. Hội nghị truyền hình đã kết thúc (STATE=ENDED) nhưng các hiện vật chưa được tạo. startTime và endTime cho hội nghị cũng được điền sẵn. Bạn phải thăm dò điểm cuối cấu phần phần mềm cho đến khi đối tượng cấu phần phần mềm STATE đọc FILE_GENERATED.

    Thay vì thăm dò, bạn có thể đăng ký nhận thông báo đẩy về các sự kiện trên Meet.

  8. Nhận các tài liệu sau hội nghị. Bạn có thể truy xuất các cấu phần phần mềm như bản ghi và bản chép lời sau khi chúng được tạo. Ví dụ: gọi phương thức conferenceRecords.recordings.get để lấy bản ghi theo mã bản ghi.

    Sau khi sẵn sàng, một URI đến đối tượng cấu phần phần mềm sẽ được điền sẵn và trả về trong đối tượng tài nguyên.