Phản hồi các sự kiện từ Google Meet

Tài liệu này giải thích cách nhận và phản hồi các sự kiện Google Meet từ Google Cloud Pub/Sub.

Sự kiện Meet biểu thị một hoạt động hoặc thay đổi đối với một tài nguyên Meet, chẳng hạn như tạo một cuộc họp mới. Bạn có thể sử dụng sự kiện để tìm hiểu những gì đã xảy ra, sau đó thực hiện hành động hoặc phản hồi theo cách có ý nghĩa cho người dùng.

Sau đây là một số ví dụ về cách bạn có thể sử dụng sự kiện:

  • Theo dõi và phản hồi các thay đổi trong cuộc họp, chẳng hạn như khi cuộc họp bắt đầu hoặc kết thúc.

  • Theo dõi những người tham dự cuộc họp cho mục đích quản lý hoặc đào tạo.

  • Nghe bản chép lời cuộc họp để có thể phân tích cú pháp nội dung tệp và ghi vào CRM hoặc cơ sở dữ liệu.

Cách hoạt động của sự kiện

Bất cứ khi nào có sự kiện xảy ra trong Google Meet, một tài nguyên Google Meet REST API sẽ được tạo hoặc cập nhật. Meet sử dụng các sự kiện để gửi thông tin đến ứng dụng của bạn về loại hoạt động đã xảy ra và tài nguyên Meet REST API bị ảnh hưởng.

Ví dụ về cách một không gian họp mới kích hoạt một sự kiện.
Hình 1. Người dùng tạo một không gian họp, thao tác này sẽ tạo ra một tài nguyên Space. Sau đó, Meet sẽ tạo một sự kiện chứa dữ liệu về không gian họp mới.

Meet phân loại các sự kiện theo loại. Các loại sự kiện giúp bạn lọc và chỉ nhận loại thông tin bạn cần, đồng thời cho phép bạn xử lý các hoạt động tương tự theo cùng một cách.

Ví dụ sau đây cho thấy cách một hoạt động trong Meet ảnh hưởng đến một tài nguyên API REST Meet có liên quan và loại sự kiện mà ứng dụng Meet của bạn nhận được:

Hoạt động Tài nguyên Meet REST API Loại sự kiện
Người dùng tham gia một không gian họp. Tài nguyên ConferenceRecord sẽ được tạo. Kỷ lục mới ở giải liên đoàn

Nhận dữ liệu sự kiện từ Google Meet

Để nhận dữ liệu sự kiện, ứng dụng của bạn có thể thực hiện một trong những thao tác sau:

Bảng sau đây giải thích sự khác biệt và lý do nên đăng ký nhận sự kiện thay vì truy vấn sự kiện:

Đăng ký nhận thông báo về sự kiện Truy vấn dữ liệu
Trường hợp sử dụng
  • Xử lý hoặc phản hồi các sự kiện theo thời gian thực.
  • Theo dõi các thay đổi về tài nguyên để cải thiện hiệu suất của ứng dụng.
  • Truy xuất dữ liệu theo cách thủ công.
  • Lấy tất cả dữ liệu từ Meet (do sự cố ngừng hoạt động hoặc gói thuê bao không hoạt động).
API Google Workspace Events API API REST của Meet
Nguồn sự kiện Số lần hội ý và người dùng Không gian và bản ghi hội nghị
Sự kiện được hỗ trợ Bản ghi hội nghị

Để xem danh sách các loại sự kiện được hỗ trợ, hãy xem phần Các loại sự kiện để tạo lượt đăng ký trong tài liệu về Google Workspace Events API. 		Không gian và bản ghi hội nghị

Để xem danh sách các điểm cuối được hỗ trợ, hãy xem tài nguyên Space và tài nguyên ConferenceRecord trong tài liệu về API REST của Meet.
Định dạng sự kiện Một thông báo Google Cloud Pub/Sub, được định dạng theo quy cách CloudEvent. Để biết thông tin chi tiết, hãy xem phần Cấu trúc của các sự kiện trên Google Workspace. Tài nguyên Meet REST API (Space và ConferenceRecord)
Dữ liệu sự kiện Chuỗi được mã hoá Base64 có hoặc không có dữ liệu tài nguyên. Để biết ví dụ về tải trọng, hãy xem phần Dữ liệu sự kiện. Tải trọng JSON chứa dữ liệu tài nguyên. Để biết ví dụ về tải trọng, hãy xem tài nguyên ConferenceRecord trong tài liệu tham khảo.

Ví dụ: Truy xuất sự kiện về người tham gia trong một không gian họp

Trong ví dụ này, một ứng dụng Meet muốn nhận thông tin về các thay đổi của người tham gia trong một không gian họp. Trong không gian họp, một người tham gia sẽ tham gia một hội nghị đang diễn ra, hội nghị này sẽ điền sẵn một tài nguyên ParticipantSession và kích hoạt một sự kiện mới. Sau đó, bạn có thể nhận thông tin về những sự kiện này bằng cách sử dụng phương thức subscribe hoặc query.

Đăng ký nhận thông báo về sự kiện

Để nhận sự kiện theo thời gian thực, ứng dụng Meet sẽ gọi phương thức subscriptions.create Google Workspace Events API để đăng ký không gian cuộc họp cho tất cả các loại sự kiện. Sau khi bạn tạo gói thuê bao, ứng dụng Meet có thể bắt đầu nhận các sự kiện.

Một ứng dụng Meet đăng ký các sự kiện của người tham gia bằng Google Workspace Events API.
Hình 2. Ứng dụng Meet nhận các sự kiện của người tham gia thông qua một gói thuê bao bằng Google Workspace Events API.

Trong hình 2, ứng dụng Meet có một thuê bao đang hoạt động cho không gian họp, vì vậy, ứng dụng sẽ nhận được một sự kiện bất cứ khi nào phiên của người tham gia thay đổi trong không gian họp. Sau đó, ứng dụng Meet có thể phản hồi theo thời gian thực đối với bất kỳ hoạt động nào, chẳng hạn như biết khi nào người tham gia tham gia hoặc rời khỏi một hội nghị đang diễn ra.

Để tìm hiểu về cách tạo các sự kiện định kỳ bằng Google Workspace Events API, hãy xem tài liệu về Google Workspace Events API.

Truy vấn các sự kiện gần đây

Thay vì nhận các sự kiện khi chúng xảy ra, ứng dụng Meet cũng có thể gọi Meet REST API để liệt kê các sự kiện gần đây trong không gian họp có liên quan đến hoạt động của người tham gia.

Một ứng dụng Meet truy vấn các sự kiện của người tham gia bằng Meet REST API.
Hình 3. Ứng dụng Meet nhận các sự kiện gần đây của người tham gia bằng cách truy vấn các sự kiện trong không gian họp bằng Meet REST API.

Trong hình 3, ứng dụng Meet gọi phương thức conferenceRecords.participants.participantSessions.list Meet REST API sau khi tất cả hoạt động của phiên người tham gia đã diễn ra. Meet REST API trả về danh sách các tài nguyên ParticipantSession đại diện cho từng thay đổi. Sau đó, ứng dụng Meet có thể xử lý hoặc phản hồi dựa trên hoạt động gần đây, chẳng hạn như tạo danh sách những người tham gia đã tham gia và rời khỏi hội nghị.

Để truy vấn các sự kiện bằng Meet REST API, hãy xem phần Liệt kê tất cả các phiên của người tham gia.

Các điểm hạn chế
  • Người được mời tham gia sự kiện trên Lịch và những người tham gia khác được mời tham gia hội nghị truyền hình chỉ có thể nhận được các sự kiện sau: google.workspace.meet.conference.v2.started và google.workspace.meet.transcript.v2.fileGenerated.