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 API REST giúp bạn tạo và quản lý cuộc họp cho Google Meet.

Không gian họp đại diện cho một địa điểm ảo hoặc một đối tượng liên tục (chẳng hạn như phòng họp) nơi tổ chức các hội nghị. Tại bất kỳ thời điểm nào, chỉ có thể tổ chức một hội nghị đang hoạt động trong một không gian. Không gian 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 bài viết Đị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 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 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
bằng chế độ cài đặt x
bằng hội nghị đang hoạt động x x
patch x

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

Google Meet API REST tạo spaces tài nguyên 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 hội nghị.

Bảng sau đây cho biết cách xác định và tham gia 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 không gian 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à có phân biệt chữ hoa chữ thường. Ví dụ: spaces/jQCFfuBOdN5z.
meetingCode Tên thay thế 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. Chuỗi này được định dạng là spaces/{meetingCode}. Ví dụ: spaces/abc-mnop-xyz. Chiều dài tối đa là 128 ký tự. Chuỗi này tạo thành một phần của meetingUri: https://meet.google.com/abc-mnop-xyz.
phoneAccess Các phương thức truy cập bằng đ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 để gọi điện đến một hội nghị, bao gồm 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ỉ bao gồm các chữ số thập phân và độ dài có thể khác nhau. 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 tập hợp giới hạn các số điện thoại. 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 cung cấp 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 hội nghị 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 sử 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 tên thay thế 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ể sử 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ị đang hoạt động trong một không gian họp, bạn chỉ có thể sử dụng spaces/{space}. Để biết thêm thông tin, hãy xem bài viết Kết thúc hội nghị đang hoạt động.

Vòng đời của không gian họp

Không gian họp trải qua một số trạng thái trong vòng đời của mình. 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 họp.

  1. Gọ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 được phân phối cho những người tham gia.

  2. Thăm dò 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ò, bạn cũng có thể đăng ký các sự kiệ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 meetingUri bên trong không gian họp, một hội nghị sẽ bắt đầu. Đối tượng activeConference được điền và chuỗi activeConference.conferenceRecord được đặt.

  4. (Không bắt buộc) Nhận dữ liệu hội nghị. Trong một hội nghị đang hoạt động, bạn có thể truy cập vào một số giá trị conferenceRecord. Ví dụ: gọi conferenceRecords.participants.list phương thức để 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ị. 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 hoạt động theo phương thức lập trình đối với tất cả người tham gia.

  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. Thăm dò cấu phần phần mềm sau hội nghị. Hội nghị đã kết thúc (STATE=ENDED) nhưng cấu phần phần mềm chưa được tạo. startTime và endTime cho hội nghị cũng được điề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ý các sự kiện Meet để nhận thông báo đẩy.

  8. Nhận cấu phần phần mềm 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 conferenceRecords.recordings.get phương thức để nhận 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 và trả về như một phần của đối tượng tài nguyên.