REST Resource: registrations

資源：Registration

指示 Classroom 將「feed」的通知傳送到所提供的目的地。

JSON 表示法 
{
  "registrationId": string,
  "feed": {
    object (Feed)
  },
  "expiryTime": string,

  // Union field destination can be only one of the following:
  "cloudPubsubTopic": {
    object (CloudPubsubTopic)
  }
  // End of list of possible types for union field destination.
}
欄位
registrationId

string

伺服器為這部 Registration 產生的專屬 ID。

唯讀。
feed

object (Feed)

指定 Classroom 應傳送至目的地的通知類別。
expiryTime

string (Timestamp format)

Registration 的有效時間。

此為伺服器指派的唯讀欄位。

RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
聯集欄位 destination。通知的傳送目的地。destination 只能是下列其中一項：
cloudPubsubTopic

object (CloudPubsubTopic)

要接收通知的 Cloud Pub/Sub 主題。

動態消息

應用程式可註冊接收的通知類別。例如：「網域的所有成員名單變更」。

JSON 表示法 
{
  "feedType": enum (FeedType),

  // Union field info can be only one of the following:
  "courseRosterChangesInfo": {
    object (CourseRosterChangesInfo)
  },
  "courseWorkChangesInfo": {
    object (CourseWorkChangesInfo)
  }
  // End of list of possible types for union field info.
}
欄位
feedType

enum (FeedType)

動態饋給類型。
聯集欄位 info。動態饋給的其他參數。info 只能是下列其中一項：
courseRosterChangesInfo

object (CourseRosterChangesInfo)

feedType 為 COURSE_ROSTER_CHANGES 的 Feed 相關資訊。如果 feedType 為 COURSE_ROSTER_CHANGES，就必須指定此欄位。
courseWorkChangesInfo

object (CourseWorkChangesInfo)

feedType 為 COURSE_WORK_CHANGES 的 Feed 相關資訊。如果 feedType 為 COURSE_WORK_CHANGES，就必須指定此欄位。

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

string

訂閱學生名單變動的課程的 courseId。

CourseWorkChangesInfo

feedType 為 COURSE_WORK_CHANGES 的 Feed 相關資訊。

JSON 表示法 
{
  "courseId": string
}
欄位
courseId

string

訂閱工作變更課程的 courseId。

CloudPubsubTopic

Cloud Pub/Sub 主題的參考資料。

如要註冊通知，主題擁有者必須將 projects.topics.publish 權限授予 classroom-notifications@system.gserviceaccount.com。

JSON 表示法 
{
  "topicName": string
}
欄位
topicName

string

Cloud Pub/Sub 主題的 name 欄位。

方法

create

 建立 Registration，讓 Classroom 開始從提供的 feed 傳送通知到 cloudPubSubTopic 提供的目的地。

delete

 刪除Registration，導致 Classroom 停止傳送該Registration的通知。