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

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

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

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

Gói thuê bao của Google Workspace giúp bạn nhận các sự kiện về những loại thay đổi sau trong Meet:

Những tài nguyên mà bạn có thể theo dõi để xác định sự kiện

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

API Sự kiện của Google Workspace hỗ trợ các tài nguyên mục tiêu sau đây dành cho Meet:

Tài nguyên mục tiêu Định dạng Các giới hạn (nếu có)
Không gian tổ chức hội nghị //meet.googleapis.com/spaces/SPACE

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

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

Gói thuê bao này nhận được các sự kiện về không gian họp có nơi người dùng là một trong những người dùng sau:

  • Chủ sở hữu không gian họp.
  • Người tổ chức về sự kiện trên Lịch Google 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 gói thuê bao cho tài nguyên trên Meet, bạn sẽ sử dụng eventTypes[] để chỉ định loại sự kiện bạn muốn nhận. Các loại sự kiện là theo thông số kỹ thuật của CloudEvents, chẳng hạn như google.workspace.APPLICATION.RESOURCE.VERSION.ACTION. Ví dụ: để nhận sự kiện về những người tham gia mới trong một hội nghị về một Với không gian trên 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 sự kiện công việc, xem Cấu trúc của Google Workspace sự kiện.

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

Loại sự kiện Nội dung mô tả Tài nguyên trên Meet

google.workspace.meet.conference.v2.started

Một hội nghị truyền hình bắt đầu trong không gian tổ chức cuộc họp.

conferenceRecord

google.workspace.meet.conference.v2.ended

Một hội nghị kết thúc tại không gian tổ chức cuộc họp.

conferenceRecord

google.workspace.meet.participant.v2.joined

Một người tham gia một hội nghị truyền hình đang diễn ra trong không gian họp.

conferenceRecord.participantSession

google.workspace.meet.participant.v2.left

Một người tham gia rời khỏi một hội nghị truyền hình đang diễn ra trong không gian họp.

conferenceRecord.participantSession

google.workspace.meet.recording.v2.fileGenerated

Hệ thống sẽ tạo một tệp bản ghi cho một hội nghị trong không gian họp.

conferenceRecord.recording

google.workspace.meet.transcript.v2.fileGenerated

Hệ thống sẽ tạo tệp bản chép lời cho một hội nghị trong không gian họp.

conferenceRecord.transcript

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 sự kiện trong Không gian họp trên Meet.

Khi gói thuê bao Google Workspace của bạn nhận được một sự kiện từ Meet, data trường 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ý các sự kiện liên quan đến bản chép lời mới trong một không gian, trọng tải của những sự kiện này chứa thông tin về 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ề các tải trọng JSON cho một gói thuê bao không gian hội họp trên Meet. Các ví dụ sử dụng hội nghị truyền hình conferenceRecords/AAA-BBB-CCC-DDD-EEE diễn ra trong không gian. Đối với mỗi sự kiện mà gói thuê bao nhận được, thì 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 trong không gian tổ chức cuộc 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/AAA-BBB-CCC-DDD-EEE"
    }
}
Một người tham gia hội nghị trong không gian họp của Meet.

google.workspace.meet.participant.v2.joined

Không bao gồm dữ liệu tài nguyên
{
    "participantSession":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/participants/FFF-GGG-HHH-III-JJJ/participantSessions/LLL-MMM-NNN-OOO-PPP"
    }
}
Hệ thống sẽ tạo bản ghi cho một hội nghị trong không gian họp trên Meet. google.workspace.meet.recording.v2.fileGenerated
Không bao gồm dữ liệu tài nguyên
{
    "recording":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/recordings/LLL-MMM-NNN-OOO-PPP"
    }
}
Hệ thống sẽ tạo bản chép lời cho một hội nghị trong không gian 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/AAA-BBB-CCC-DDD-EEE/transcripts/PPP-QQQ-RRR-SSS-TTT"
    }
}