- Tài nguyên: Đơn đăng ký
- Nguồn cấp dữ liệu
- FeedType
- CourseRosterChangesInfo
- CourseWorkChangesInfo
- CloudPubsubTopic
- Phương thức
Tài nguyên: Đăng ký
Hướng dẫn Lớp học gửi thông báo từ feed
đến đích đến đã cung cấp.
Biểu diễn dưới dạng JSON |
---|
{ "registrationId": string, "feed": { object ( |
Trường | |
---|---|
registrationId |
Một giá trị nhận dạng riêng biệt do máy chủ tạo cho Chỉ có thể đọc. |
feed |
Thông số kỹ thuật cho lớp thông báo mà Lớp học sẽ gửi đến đích đến. |
expiryTime |
Khoảng thời gian cho đến khi Đây là trường chỉ đọc do máy chủ chỉ định. Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: |
Trường kết hợp destination . Địa chỉ gửi thông báo. destination chỉ có thể là một trong những trạng thái sau đây: |
|
cloudPubsubTopic |
Chủ đề Cloud Pub/Sub nơi thông báo sẽ được gửi đến. |
Nguồn cấp dữ liệu
Một loại thông báo mà ứng dụng có thể đăng ký nhận. Ví dụ: "tất cả thay đổi trong danh sách cho một miền".
Biểu diễn dưới dạng JSON |
---|
{ "feedType": enum ( |
Trường | |
---|---|
feedType |
Loại nguồn cấp dữ liệu. |
Trường kết hợp info . Các tham số bổ sung về nguồn cấp dữ liệu. info chỉ có thể là một trong những trạng thái sau đây: |
|
courseRosterChangesInfo |
Thông tin về |
courseWorkChangesInfo |
Thông tin về |
FeedType
Loại nguồn cấp dữ liệu mà ứng dụng có thể đăng ký nhận thông báo.
Enum | |
---|---|
FEED_TYPE_UNSPECIFIED |
Tuyệt đối không được trả lại hoặc cung cấp. |
DOMAIN_ROSTER_CHANGES |
Tất cả thay đổi trong danh sách cho một miền cụ thể. Hệ thống sẽ tạo thông báo mỗi khi người dùng tham gia hoặc rời khỏi khoá học. Hệ thống sẽ không tạo thông báo khi lời mời được tạo hoặc bị xoá, nhưng hệ thống sẽ tạo thông báo khi người dùng tham gia khoá học bằng cách chấp nhận lời mời. |
COURSE_ROSTER_CHANGES |
Tất cả thay đổi về đội hình cho một khoá học cụ thể. Hệ thống sẽ tạo thông báo mỗi khi người dùng tham gia hoặc rời khỏi khoá học. Hệ thống sẽ không tạo thông báo khi lời mời được tạo hoặc bị xoá, nhưng hệ thống sẽ tạo thông báo khi người dùng tham gia khoá học bằng cách chấp nhận lời mời. |
COURSE_WORK_CHANGES |
Tất cả hoạt động làm bài tập trong một khoá học cụ thể. Hệ thống sẽ tạo thông báo khi tạo hoặc sửa đổi đối tượng Bài tập môn học hoặc Bài tập của học viên. Hệ thống sẽ không tạo thông báo khi một đối tượng Bài tập của học viên được tạo liên quan đến việc tạo hoặc sửa đổi đối tượng CourseWork gốc (nhưng hệ thống sẽ tạo thông báo khi tạo hoặc sửa đổi đối tượng CourseWork đó). |
CourseRosterChangesInfo
Thông tin về Feed
có feedType
là COURSE_ROSTER_CHANGES
.
Biểu diễn dưới dạng JSON |
---|
{ "courseId": string } |
Trường | |
---|---|
courseId |
|
CourseWorkChangesInfo
Thông tin về Feed
có feedType
là COURSE_WORK_CHANGES
.
Biểu diễn dưới dạng JSON |
---|
{ "courseId": string } |
Trường | |
---|---|
courseId |
|
CloudPubsubTopic
Tài liệu tham khảo về một chủ đề trên Cloud Pub/Sub.
Để đăng ký nhận thông báo, chủ sở hữu chủ đề phải cấp quyền projects.topics.publish
cho classroom-notifications@system.gserviceaccount.com
.
Biểu diễn dưới dạng JSON |
---|
{ "topicName": string } |
Trường | |
---|---|
topicName |
Trường |
Phương thức |
|
---|---|
|
Tạo Registration , khiến Lớp học bắt đầu gửi thông báo từ feed được cung cấp đến đích được cung cấp trong cloudPubSubTopic . |
|
Xoá một Registration , khiến Lớp học ngừng gửi thông báo cho Registration đó. |