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

Trang này mô tả các sự kiện trên Google Meet mà ứng dụng của bạn có thể đăng ký nhận thông báo bằng Google Workspace Events API. Sau khi quyết định loại sự kiện bạn cần, hãy tạo một lượt đăng ký để bắt đầu nhận sự kiện từ Meet.

Để tìm hiểu thêm về cách phát triển ứng dụng cho Meet, hãy xem phần Tổng quan về API REST của Google Meet.

Các sự kiện được Meet hỗ trợ

Gói thuê bao Google Workspace cho phép bạn nhận các sự kiện về những loại thay đổi sau đây trong Meet:

• Một hội nghị bắt đầu hoặc kết thúc trong không gian họp.
• Người tham gia tham gia hoặc rời khỏi một hội nghị.
• Một bản ghi được tạo cho một hội nghị truyền hình.
• Bản chép lời được tạo cho một hội nghị truyền hình.

Tài nguyên mà bạn có thể theo dõi sự kiện

Để nhận sự kiện, bạn chỉ định một tài nguyên Meet cần theo dõi, được gọi là tài nguyên đích của gói thuê bao.

Google Workspace Events API hỗ trợ các tài nguyên mục tiêu sau đây cho Meet:

Các loại sự kiện để tạo gói thuê bao

Khi tạo một lượt đăng ký nhận thông báo về tài nguyên Meet, bạn sẽ dùng trường eventTypes[] để chỉ định những loại sự kiện mà bạn muốn nhận. Các loại sự kiện được định dạng theo quy cách CloudEvents, chẳng hạn như google.workspace.APPLICATION.RESOURCE.VERSION.ACTION.

Ví dụ: để nhận sự kiện về người tham gia mới trong một hội nghị cho không gian Meet, bạn chỉ định loại sự kiện là google.workspace.meet.participant.v2.joined. Để tìm hiểu thêm về cách hoạt động của các sự kiện, hãy xem Cấu trúc của các sự kiện trên Google Workspace.

Bảng sau đây cho thấy các loại sự kiện được hỗ trợ, nội dung mô tả và tài nguyên Meet đã thay đổi được biểu thị trong dữ liệu sự kiện:

Dữ liệu sự kiện

Phần này mô tả dữ liệu sự kiện và các tải trọng mẫu cho các sự kiện trong không gian họp của Meet.

Khi gói thuê bao Google Workspace của bạn nhận được một sự kiện từ Meet, trường data sẽ chứa tải trọng cho sự kiện đó. Tải trọng này có thông tin về tài nguyên Google Workspace đã thay đổi. Ví dụ: nếu bạn đã đăng ký nhận thông báo về các sự kiện liên quan đến bản chép lời mới trong một không gian, thì tải trọng cho các sự kiện này sẽ chứa thông tin về tài nguyên transcript đã thay đổi.

Dữ liệu tài nguyên trong tải trọng sự kiện

Bảng sau đây cung cấp ví dụ về tải trọng JSON cho một lượt đăng ký không gian họp trên Meet. Các ví dụ này sử dụng mã hồ sơ hội nghị (ví dụ: conferenceRecords/AAA-BBB-CCC-DDD-EEE) để xác định không gian họp. Để biết thêm thông tin, hãy xem bài viết Cách Meet xác định không gian họp.

Đối với mỗi sự kiện mà gói thuê bao nhận được, tải trọng sẽ xuất hiện trong trường data của sự kiện:

{
    "conferenceRecord":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID"
    }
}
      

{
    "participantSession":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
    }
}
      

{
    "recording":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
    }
}
      

{
    "transcript":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
    }
}
      

Chủ đề có liên quan

• Tổng quan về Google Workspace Events API
• Cấu trúc của các sự kiện trên Google Workspace
• Chọn phạm vi Google Workspace Events API
• Tổng quan về API REST của Google Meet
• Chọn các phạm vi của API REST Google Meet
• Hướng dẫn: Theo dõi các sự kiện trong cuộc họp bằng Python và Google Meet REST API