REST Resource: registrations

資源：註冊

指示 Classroom 將 feed 的通知傳送至指定目的地。

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

  "cloudPubsubTopic": {
    object (CloudPubsubTopic)
  }
}
欄位
registrationId

string

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

唯讀。
feed

object (Feed)

Classroom 應傳送至目的地的通知類別規格。
expiryTime

string (Timestamp format)

Registration 的有效期限。

這是由伺服器指派的唯讀欄位。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
通知傳送位置。以下是互斥欄位清單。回應中最多會設定下列其中一個欄位：
cloudPubsubTopic

object (CloudPubsubTopic)

要接收通知的 Cloud Pub/Sub 主題。
互斥欄位結束。

動態消息

應用程式可註冊接收的一類通知。例如：「網域的所有學生名單異動」。

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

  "courseRosterChangesInfo": {
    object (CourseRosterChangesInfo)
  },
  "courseWorkChangesInfo": {
    object (CourseWorkChangesInfo)
  }
}
欄位
feedType

enum (FeedType)

動態饋給類型。
動態饋給的其他參數。以下是互斥欄位清單。回應中最多會設定下列其中一個欄位：
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 物件時，系統會產生通知。建立或修改父項 CourseWork 物件時，如果一併建立 StudentSubmission 物件，系統不會產生通知 (但會針對 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 的通知。