Đă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 Meet mà ứng dụng của bạn có thể đăng ký bằng API Google Workspace Events. 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 API REST của Google Meet. Gọi API REST của Meet để truy xuất các sự kiện theo định kỳ hoặc cập nhật các sự kiện mà bạn có thể đã bỏ lỡ trong một gói thuê bao do sự cố ngừng hoạt động. Để tìm hiểu về các cách bạn có thể nhận và phản hồi sự kiện trên Meet, hãy xem bài viết Phản hồi sự kiện từ 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 Meet.

Sự kiện được hỗ trợ trên Meet

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

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

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

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

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

Loại sự kiện để tạo gói thuê bao

Khi bạn tạo gói thuê bao cho một tài nguyên Meet, hãy sử dụng trường eventTypes[] để chỉ định 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 của 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 một không gian họp, hãy 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 sự kiện, hãy xem phần Cấu trúc của 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 gói thuê bao đối với tài nguyên của Meet:

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 đó. Trọng tải 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 sự kiện về 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 gói thuê bao đối với một 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 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"
  }
}
      

{
  "smartNote":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/smartNotes/SMART_NOTE_ID"
  }
}
      

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

• 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.

Chủ đề có liên quan

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