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ý bằng API Sự kiện của Google Workspace. Sau khi bạn quyết định loại sự kiện mình cần, hãy tạo một gói thuê bao để 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 tổng quan về API REST của Google Meet.
Các sự kiện Meet được hỗ trợ
Gói thuê bao Google Workspace cho phép bạn nhận các sự kiện về các loại thay đổi sau trong Meet:
- Hội nghị bắt đầu hoặc kết thúc trong không gian họp.
- Một người tham gia tham gia hoặc rời khỏi một cuộc họp.
- Hệ thống sẽ tạo một bản ghi cho hội nghị.
- Hệ thống sẽ tạo một bản chép lời cho một hội nghị.
Các 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 để 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 Sự kiện của Google Workspace 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ọ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 |
|
| Người dùng | //cloudidentity.googleapis.com/users/USER
trong đó USER là mã nhận dạng trong trường
|
Gói thuê bao này nhận được các sự kiện về không gian họp mà người dùng là một trong những người sau:
|
Các loại sự kiện để tạo gói thuê bao
Khi tạo gói thuê bao cho một tài nguyên Meet, bạn sẽ sử dụng trường eventTypes[] để chỉ định loại sự kiện bạn muốn nhận. Các loại sự kiện được định dạng theo thông số kỹ thuật CloudEvents, chẳng hạn như google.workspace.APPLICATION.RESOURCE.VERSION.ACTION.
Ví dụ: để nhận các sự kiện về người tham gia mới trong một cuộc họp trên 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 sự kiện, hãy xem phần Cấu trúc của sự kiện trong 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 thể hiện trong dữ liệu sự kiện:
| Loại sự kiện | Nội dung mô tả | Tài nguyên về Meet |
|---|---|---|
|
Cuộc họp bắt đầu trong không gian họp. |
|
|
Hội nghị kết thúc trong phòng họp. |
|
|
Một người tham gia tham gia một cuộc họp đang diễn ra trong không gian họp. |
|
|
Một người tham gia rời khỏi cuộc họp đang hoạt động trong không gian họp. |
|
|
Tệp ghi lại được tạo cho một cuộc họp trong phòng họp. |
|
|
Tệp bản chép lời được tạo cho một cuộc họp trong không gian họp. |
|
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 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 đó. Gói dữ liệu 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 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 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 gói thuê bao không gian họp trên Meet. Các ví dụ sử dụng conferenceRecords/AAA-BBB-CCC-DDD-EEE hội nghị diễn ra trong không gian. Đối với mỗi sự kiện mà gói thuê bao nhận được, trọng tải sẽ xuất hiện trong trường data của sự kiện:
| Ví dụ | Loại sự kiện | Gói dữ liệu JSON |
|---|---|---|
Một cuộc họp bắt đầu cho không gian họp trên Meet. |
|
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 tham gia hội nghị trong không gian họp trên Meet. |
|
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"
}
}
|
| Bản ghi được tạo cho một cuộc họp 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"
}
}
|
| Bản chép lời được tạo cho một cuộc họp 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"
}
}
|