REST Resource: registrations

แหล่งข้อมูล: การลงทะเบียน

คำสั่งให้ 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 นี้

อ่านอย่างเดียว
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"
ฟิลด์ Union 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)

ประเภทของฟีด
ฟิลด์ Union info พารามิเตอร์เพิ่มเติมเกี่ยวกับฟีด info ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
courseRosterChangesInfo

object (CourseRosterChangesInfo)

ข้อมูลเกี่ยวกับ Feed ที่มี feedType เป็น COURSE_ROSTER_CHANGES ต้องระบุช่องนี้หาก feedType เป็น COURSE_ROSTER_CHANGES
courseWorkChangesInfo

object (CourseWorkChangesInfo)

ข้อมูลเกี่ยวกับ Feed ที่มี feedType เป็น COURSE_WORK_CHANGES ต้องระบุช่องนี้หาก feedType เป็น COURSE_WORK_CHANGES

FeedType

ประเภทฟีดที่แอปพลิเคชันสามารถลงทะเบียนเพื่อรับการแจ้งเตือนได้

Enum
FEED_TYPE_UNSPECIFIED ไม่ควรส่งคืนหรือให้
DOMAIN_ROSTER_CHANGES

การเปลี่ยนแปลงรายชื่อทั้งหมดสำหรับโดเมนหนึ่งๆ

ระบบจะสร้างการแจ้งเตือนทุกครั้งที่ผู้ใช้เข้าร่วมหรือออกจากหลักสูตร

ระบบจะไม่สร้างการแจ้งเตือนเมื่อมีการสร้างหรือลบคำเชิญ แต่จะสร้างการแจ้งเตือนเมื่อผู้ใช้เข้าร่วมหลักสูตรโดยการยอมรับคำเชิญ
COURSE_ROSTER_CHANGES

การเปลี่ยนแปลงรายชื่อทั้งหมดสำหรับหลักสูตรหนึ่งๆ

ระบบจะสร้างการแจ้งเตือนทุกครั้งที่ผู้ใช้เข้าร่วมหรือออกจากหลักสูตร

ระบบจะไม่สร้างการแจ้งเตือนเมื่อมีการสร้างหรือลบคำเชิญ แต่จะสร้างการแจ้งเตือนเมื่อผู้ใช้เข้าร่วมหลักสูตรโดยการยอมรับคำเชิญ
COURSE_WORK_CHANGES

กิจกรรมงานทั้งหมดในหลักสูตรที่เฉพาะเจาะจง

ระบบจะสร้างการแจ้งเตือนเมื่อมีการสร้างหรือแก้ไขออบเจ็กต์ CourseWork หรือ StudentSubmission ระบบจะไม่สร้างการแจ้งเตือนเมื่อมีการสร้างออบเจ็กต์ StudentSubmission ที่เชื่อมโยงกับการสร้างหรือแก้ไขออบเจ็กต์ CourseWork หลัก (แต่จะมีการสร้างการแจ้งเตือนสำหรับการสร้างหรือแก้ไขออบเจ็กต์ CourseWork นั้น)

CourseRosterChangesInfo

ข้อมูลเกี่ยวกับ Feed ที่มี feedType เป็น COURSE_ROSTER_CHANGES

การแสดง JSON 
{
  "courseId": string
}
ช่อง
courseId

string

courseId ของหลักสูตรที่จะสมัครรับการเปลี่ยนแปลงบัญชีรายชื่อ

CourseWorkChangesInfo

ข้อมูลเกี่ยวกับ Feed ที่มี feedType เป็น COURSE_WORK_CHANGES

การแสดง JSON 
{
  "courseId": string
}
ช่อง
courseId

string

courseId ของหลักสูตรที่จะสมัครรับการเปลี่ยนแปลงงาน

CloudPubsubTopic

การอ้างอิงถึงหัวข้อ Cloud Pub/Sub

หากต้องการลงทะเบียนรับการแจ้งเตือน เจ้าของหัวข้อต้องให้สิทธิ์ classroom-notifications@system.gserviceaccount.com projects.topics.publish

การแสดง JSON 
{
  "topicName": string
}
ช่อง
topicName

string

ฟิลด์ name ของ Topic ใน Cloud Pub/Sub

เมธอด

create

 สร้าง Registration ทำให้ Classroom เริ่มส่งการแจ้งเตือนจาก feed ที่ระบุไปยังปลายทางที่ระบุใน cloudPubSubTopic

delete

 ลบ Registration ทำให้ Classroom หยุดส่งการแจ้งเตือนสำหรับ Registration นั้น