資源:Registration
指示 Classroom 將「feed
」的通知傳送到所提供的目的地。
JSON 表示法 |
---|
{ "registrationId": string, "feed": { object ( |
欄位 | |
---|---|
registrationId |
伺服器為這部 唯讀。 |
feed |
指定 Classroom 應傳送至目的地的通知類別。 |
expiryTime |
此為伺服器指派的唯讀欄位。 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例: |
聯集欄位 destination 。通知的傳送目的地。destination 只能是下列其中一項: |
|
cloudPubsubTopic |
要接收通知的 Cloud Pub/Sub 主題。 |
動態消息
應用程式可註冊接收的通知類別。例如:「網域的所有成員名單變更」。
JSON 表示法 |
---|
{ "feedType": enum ( |
欄位 | |
---|---|
feedType |
動態饋給類型。 |
聯集欄位 info 。動態饋給的其他參數。info 只能是下列其中一項: |
|
courseRosterChangesInfo |
|
courseWorkChangesInfo |
|
FeedType
應用程式可為通知註冊的一種動態饋給。
列舉 | |
---|---|
FEED_TYPE_UNSPECIFIED |
一律不得傳回或提供。 |
DOMAIN_ROSTER_CHANGES |
特定網域的所有學生名單變更。 每當使用者加入或離開課程時,系統就會產生通知。 建立或刪除邀請時,系統不會產生任何通知,但當使用者接受邀請加入課程時,系統就會產生通知。 |
COURSE_ROSTER_CHANGES |
特定課程的所有學生名單變更。 每當使用者加入或離開課程時,系統就會產生通知。 建立或刪除邀請時,系統不會產生任何通知,但當使用者接受邀請加入課程時,系統就會產生通知。 |
COURSE_WORK_CHANGES |
特定課程的所有課程作業活動。 建立或修改 CourseWork 或 StudentSubmission 物件時,系統會產生通知。當 StudentSubmission 物件在建立或修改其上層 CourseWork 物件時,系統不會產生通知,但系統會針對該 CourseWork 物件的建立或修改通知產生通知。 |
CourseRosterChangesInfo
feedType
為 COURSE_ROSTER_CHANGES
的 Feed
相關資訊。
JSON 表示法 |
---|
{ "courseId": string } |
欄位 | |
---|---|
courseId |
訂閱學生名單變動的課程的 |
CourseWorkChangesInfo
feedType
為 COURSE_WORK_CHANGES
的 Feed
相關資訊。
JSON 表示法 |
---|
{ "courseId": string } |
欄位 | |
---|---|
courseId |
訂閱工作變更課程的 |
CloudPubsubTopic
Cloud Pub/Sub 主題的參考資料。
如要註冊通知,主題擁有者必須將 projects.topics.publish
權限授予 classroom-notifications@system.gserviceaccount.com
。
JSON 表示法 |
---|
{ "topicName": string } |
欄位 | |
---|---|
topicName |
Cloud Pub/Sub 主題的 |
方法 |
|
---|---|
|
建立 Registration ,讓 Classroom 開始從提供的 feed 傳送通知到 cloudPubSubTopic 提供的目的地。 |
|
刪除Registration ,導致 Classroom 停止傳送該Registration 的通知。 |