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 trên Google Meet từ Google Cloud Pub/Sub.

Sự kiện trên Meet đại diện cho một hoạt động hoặc thay đổi đối với tài nguyên trên Meet, chẳng hạn như tạo cuộc họp mới. Bạn có thể sử dụng các sự kiện để 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 đối với người dùng.

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

  • Quan sát 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 ghi 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 các sự kiện

Bất cứ khi nào có điều gì đó xảy ra trong Google Meet, một tài nguyên Google Meet API REST 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 API REST 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 cuộc họp, tạo tài nguyên Space. Sau đó, Meet tạo một sự kiện chứa dữ liệu về không gian cuộc 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 tài nguyên Google Meet API REST 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 Google Meet API REST Loại sự kiện
Người dùng tham gia một không gian cuộc họp. Tài nguyên ConferenceRecord được tạo. Bản ghi cuộc họp mới

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 đăng ký nhận sự kiện so với truy vấn sự kiện:

Đăng ký nhận 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 trong 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.
  • Tìm nạp tất cả dữ liệu từ Meet (do sự cố ngừng dịch vụ hoặc gói thuê bao không hoạt động).
API Google Workspace Events API API REST của Google Meet
Nguồn sự kiện Bản ghi cuộc họp và người dùng Không gian và bản ghi cuộc họp
Sự kiện được hỗ trợ Bản ghi cuộc họp

Để xem danh sách các loại sự kiện được hỗ trợ, hãy xem bài viết Các loại sự kiện để tạo gói thuê bao trong tài liệu Google Workspace Events API. 		Không gian và bản ghi cuộc họp

Để xem danh sách các điểm cuối được hỗ trợ, hãy xem Space tài nguyên và ConferenceRecord tài nguyên trong tài liệu Google Meet API REST.
Định dạng sự kiện Thông báo Google Cloud Pub/Sub, được định dạng theo thông số kỹ thuật CloudEvent Để biết thông tin chi tiết, hãy xem bài viết Cấu trúc của các sự kiện trên Google Workspace. Tài nguyên Google Meet API REST (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. Để xem các tải trọng mẫu, hãy xem bài viết Dữ liệu sự kiện. Tải trọng JSON chứa dữ liệu tài nguyên. Để xem tải trọng mẫu, hãy xem tài nguyên ConferenceRecord trong tài liệu tham khảo.

Ví dụ: Truy xuất các sự kiện về người tham gia trong không gian cuộc 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 không gian cuộc họp. Trong không gian cuộc họp, một người tham gia sẽ tham gia một hội nghị đang hoạt động, hội nghị này sẽ điền vào một ParticipantSession tài nguyên và kích hoạt một sự kiện mới. Sau đó, bạn có thể nhận thông tin về các sự kiện này bằng phương thức đăng ký hoặc truy vấn.

Đăng ký nhận 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 Google Workspace Events API subscriptions.create để đăng ký nhận tất cả các loại sự kiện cho không gian cuộc họp. Sau khi tạo gói thuê bao, ứng dụng Meet có thể bắt đầu nhận 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 gói thuê bao bằng Google Workspace Events API.

Trong hình 2, ứng dụng Meet có gói thuê bao đang hoạt động cho không gian cuộc 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 cuộc 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 hoạt động.

Để tìm hiểu về cách tạo gói thuê bao bằng Google Workspace Events API, hãy xem tài liệu Google Workspace Events API.

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

Thay vì nhận sự kiện khi chúng xảy ra, ứng dụng Meet cũng có thể gọi Meet API REST để liệt kê các sự kiện gần đây trong không gian cuộc 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 API REST.
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 cuộc họp bằng Google Meet API REST.

Trong hình 3, ứng dụng Meet gọi phương thức của API REST của Meet conferenceRecords.participants.participantSessions.list sau khi tất cả các hoạt động trong phiên của người tham gia đã xảy ra. API REST của Google Meet 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 Google Meet API REST, hãy xem bài viết 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 trên Lịch và những người tham gia khác được mời tham gia hội nghị chỉ có thể nhận các sự kiện sau: google.workspace.meet.conference.v2.started và google.workspace.meet.transcript.v2.fileGenerated.