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

Tài liệu 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ý 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 gói thuê bao để bắt đầu nhận sự kiện từ Meet.

Ngoài việc đăng ký nhận sự kiện, bạn cũng có thể truy vấn sự kiện bằng cách gọi Google Meet REST API. Gọi Meet REST API để truy xuất các sự kiện theo định kỳ hoặc nắm bắt các sự kiện mà bạn có thể đã bỏ lỡ trong một lượt đăng ký do sự cố ngừng hoạt động. Để tìm hiểu về những cách bạn có thể nhận và phản hồi sự kiện trên Meet, hãy xem phần Phản hồi sự kiện trên Google Meet trong tài liệu về Meet.

Để tìm hiểu thêm về cách phát triển ứng dụng cho Meet, hãy xem bài viết 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 trong Meet:

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 mục tiêu 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:

Tài nguyên mục tiêu Định dạng Các điểm hạn chế (nếu có)
Không gian hội họp //meet.googleapis.com/spaces/SPACE

trong đó SPACE là mã nhận dạng trong tên tài nguyên của tài nguyên spaces Meet REST API. Để biết thông tin chi tiết, hãy xem bài viết Cách Meet xác định không gian họp.
Người dùng //cloudidentity.googleapis.com/users/USER

trong đó USER là mã nhận dạng trong trường signedinUser.user của tài nguyên participants Meet REST API. Để biết thông tin chi tiết, hãy xem bài viết Làm việc với người tham gia.

Đăng ký nhận các sự kiện về tất cả không gian họp mà người dùng là chủ sở hữu. Thông thường, chủ sở hữu không gian họp cũng là người tổ chức sự kiện trên Lịch Google được liên kết với không gian họp.

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ẽ 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 biết những loại sự kiện được hỗ trợ cho các lượt đăng ký nhận thông báo về tài nguyên Meet:

Loại sự kiện Định dạng Dữ liệu tài nguyên
Một hội nghị truyền hình bắt đầu trong không gian họp. google.meet.conference.v2.started conferenceRecord
Một hội nghị kết thúc trong không gian họp. google.meet.conference.v2.ended conferenceRecord
Một người tham gia tham gia một hội nghị đang diễn ra trong không gian họp. google.meet.participant.v2.joined conferenceRecord.participantSession
Một người tham gia rời khỏi hội nghị đang diễn ra trong không gian họp. google.meet.participant.v2.left conferenceRecord.participantSession
Một tệp ghi hình được tạo cho hội nghị trong không gian họp. google.meet.recording.v2.fileGenerated conferenceRecord.recording
Một tệp bản chép lời sẽ được tạo cho một hội nghị trong không gian họp. google.meet.transcript.v2.fileGenerated conferenceRecord.transcript

Dữ liệu sự kiện

Phần này mô tả dữ liệu sự kiện và 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 transcripts đã 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ã bản ghi hội nghị (ví dụ: conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ) để xác định không gian của cuộc 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:

Ví dụ Loại sự kiện Tải trọng JSON

Một hội nghị bắt đầu cho không gian họp trên Meet.

google.workspace.meet.conference.v2.started
Không bao gồm dữ liệu tài nguyên
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID"
    }
}
Một người tham gia tham gia một hội nghị trong không gian họp trên Meet.

google.workspace.meet.participant.v2.joined
Không bao gồm dữ liệu tài nguyên
{
    "participantSession":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
    }
}
Bản ghi được tạo cho một hội nghị trong không gian họp của Meet. google.workspace.meet.recording.v2.fileGenerated
Không bao gồm dữ liệu tài nguyên
{
    "recording":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
    }
}
Bản chép lời được tạo cho một hội nghị trong không gian tổ chức cuộc họp trên Meet. google.workspace.meet.transcript.v2.fileGenerated
Không bao gồm dữ liệu tài nguyên
{
    "transcript":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
    }
}

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.