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

Ngoài việc đăng ký sự kiện, bạn cũng có thể truy vấn sự kiện bằng cách gọi Google Meet API REST. Gọi Meet API REST để truy xuất sự kiện theo định kỳ hoặc nắm bắt các sự kiện mà bạn có thể đã bỏ lỡ từ một gói thuê bao 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 các sự kiện Meet, hãy xem phần Phản hồi sự kiện từ 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 phần Tổng quan về Meet API REST.

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

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:

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

Để nhận sự kiện, hãy chỉ định một tài nguyên Meet để giám sát. Tài nguyên này đượ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 Cách Meet xác định không gian hội 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 API REST. Để biết thông tin chi tiết, hãy xem phần Làm việc với người tham gia.

Gói thuê bao nhận sự kiện về tất cả không gian hội họp mà người dùng là chủ sở hữu của không gian hội họp. Thông thường, chủ sở hữu không gian hội 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ội họp.

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 đặc tả 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ị cho không gian Meet, 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 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 Meet:

Loại sự kiện Định dạng Dữ liệu tài nguyên
Một hội nghị bắt đầu trong không gian hội họp. google.workspace.meet.conference.v2.started conferenceRecord
Một hội nghị kết thúc trong không gian hội họp. google.workspace.meet.conference.v2.ended conferenceRecord
Một người tham gia tham gia một hội nghị đang hoạt động trong không gian hội họp. google.workspace.meet.participant.v2.joined conferenceRecord.participantSession
Một người tham gia rời khỏi một hội nghị đang hoạt động trong không gian hội họp. google.workspace.meet.participant.v2.left conferenceRecord.participantSession
Một bản ghi bắt đầu cho một hội nghị trong không gian hội họp. google.workspace.meet.recording.v2.started conferenceRecord.recording
Một bản ghi kết thúc cho một hội nghị trong không gian hội họp. google.workspace.meet.recording.v2.ended conferenceRecord.recording
Một tệp bản ghi được tạo cho một hội nghị trong không gian hội họp. google.workspace.meet.recording.v2.fileGenerated conferenceRecord.recording
Một ghi chú thông minh bắt đầu cho một hội nghị trong không gian hội họp. google.workspace.meet.smartNote.v2.started conferenceRecord.smartNote
Một ghi chú thông minh kết thúc cho một hội nghị trong không gian hội họp. google.workspace.meet.smartNote.v2.ended conferenceRecord.smartNote
Một tệp ghi chú thông minh được tạo cho một hội nghị trong không gian hội họp. google.workspace.meet.smartNote.v2.fileGenerated conferenceRecord.smartNote
Bản chép lời bắt đầu cho một hội nghị trong không gian hội họp. google.workspace.meet.transcript.v2.started conferenceRecord.transcript
Một bản chép lời kết thúc cho một hội nghị trong không gian hội họp. google.workspace.meet.transcript.v2.ended conferenceRecord.transcript
Một tệp bản chép lời được tạo cho một hội nghị trong không gian hội họp. google.workspace.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à các tải trọng mẫu cho sự kiện trong không gian hội 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, 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ý 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 các ví dụ về tải trọng JSON cho gói thuê bao đối với không gian hội họp trên Meet. Các ví dụ này sử dụng mã nhận dạng bản ghi hội nghị (ví dụ: conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ) để xác định không gian hội họp. Để biết thêm thông tin, hãy xem phần Cách Meet xác định không gian hội 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:

Loại sự kiện Tải trọng JSON

Một hội nghị bắt đầu hoặc kết thúc cho không gian hội họp trên Meet.

  • google.workspace.meet.conference.v2.started
  • google.workspace.meet.conference.v2.ended

Loại trừ dữ liệu tài nguyên:

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

Một người tham gia tham gia hoặc rời khỏi một hội nghị trong không gian hội họp trên Meet.

  • google.workspace.meet.participant.v2.joined
  • google.workspace.meet.participant.v2.left

Loại trừ dữ liệu tài nguyên:

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

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ị trong không gian hội họp trên Meet.

  • google.workspace.meet.recording.v2.started
  • google.workspace.meet.recording.v2.ended
  • google.workspace.meet.recording.v2.fileGenerated

Loại trừ dữ liệu tài nguyên:

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

Một 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ị trong không gian hội họp trên Meet.

  • google.workspace.meet.smartNote.v2.started
  • google.workspace.meet.smartNote.v2.ended
  • google.workspace.meet.smartNote.v2.fileGenerated

Loại trừ dữ liệu tài nguyên:

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

Một bản chép lời bắt đầu, kết thúc hoặc một tệp được tạo cho một hội nghị trong không gian hội họp trên Meet.

  • google.workspace.meet.transcript.v2.started
  • google.workspace.meet.transcript.v2.ended
  • google.workspace.meet.transcript.v2.fileGenerated

Loại trừ 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 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ác sự kiện sau: google.workspace.meet.conference.v2.started và google.workspace.meet.transcript.v2.fileGenerated.