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 سارية.

هذا حقل للقراءة فقط يعيّنه الخادم.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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)

معلومات حول Feed مع feedType من COURSE_ROSTER_CHANGES. يجب تحديد هذا الحقل إذا كانت قيمة feedType هي COURSE_ROSTER_CHANGES.

courseWorkChangesInfo

object (CourseWorkChangesInfo)

معلومات حول Feed مع feedType من COURSE_WORK_CHANGES. يجب تحديد هذا الحقل إذا كانت قيمة feedType هي COURSE_WORK_CHANGES.

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

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 في موضوع Cloud Pub/Sub.

الطُرق

create

تنشئ Registration، ما يؤدي إلى بدء Classroom في إرسال الإشعارات من feed المقدَّمة إلى الوجهة المتوفّرة في cloudPubSubTopic.

delete

يؤدي هذا الإجراء إلى حذف Registration، ما يؤدي إلى إيقاف Classroom عن إرسال إشعارات بشأن ذلك "Registration".