- المرجع: التسجيل
- الخلاصة
- FeedType
- CourseRosterChangesInfo
- CourseWorkChangesInfo
- CloudPubsubTopic
- الطُرق
المرجع: التسجيل
تعليمات إلى Classroom لإرسال الإشعارات من "feed
" إلى الوجهة المحدّدة
تمثيل JSON |
---|
{ "registrationId": string, "feed": { object ( |
الحقول | |
---|---|
registrationId |
تمثّل هذه السمة المعرّف الفريد الذي ينشئه الخادم لهذه للقراءة فقط. |
feed |
هي المواصفات المحدّدة لفئة الإشعارات التي يجب أن يرسلها Classroom إلى الوجهة. |
expiryTime |
تمثّل هذه السمة الوقت الذي تسري فيه السمة هذا الحقل للقراءة فقط تم تخصيصه من قِبل الخادم. طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
حقل الاتحاد 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
معلومات عن Feed
مع feedType
من COURSE_ROSTER_CHANGES
.
تمثيل JSON |
---|
{ "courseId": string } |
الحقول | |
---|---|
courseId |
|
CourseWorkChangesInfo
معلومات عن Feed
مع feedType
من COURSE_WORK_CHANGES
.
تمثيل JSON |
---|
{ "courseId": string } |
الحقول | |
---|---|
courseId |
يتغير |
CloudPubsubTopic
مرجع إلى موضوع Cloud Pub/Sub.
للتسجيل لتلقّي إشعارات، يجب أن يمنح مالك الموضوع classroom-notifications@system.gserviceaccount.com
الإذن projects.topics.publish
.
تمثيل JSON |
---|
{ "topicName": string } |
الحقول | |
---|---|
topicName |
الحقل |
الطُرق |
|
---|---|
|
ينشئ هذا الإعداد Registration ، ما يؤدي إلى بدء Classroom بإرسال إشعارات من feed المتوفرة إلى الوجهة المقدَّمة في cloudPubSubTopic . |
|
يؤدي هذا الإجراء إلى حذف Registration ، ما يؤدي إلى توقُّف Classroom عن إرسال الإشعارات بشأن Registration . |