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.

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 được 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 đượ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.

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.