REST Resource: registrations

संसाधन: रजिस्ट्रेशन

Classroom को निर्देश, ताकि वह feed से बताए गए डेस्टिनेशन पर सूचनाएं भेज सके.

जेएसओएन के काेड में दिखाना
{
  "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 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

यूनियन फ़ील्ड destination. सूचनाएं कहां भेजी जानी चाहिए. destination इनमें से सिर्फ़ एक हो सकता है:
cloudPubsubTopic

object (CloudPubsubTopic)

वह Cloud Pub/Sub विषय, जिसके लिए सूचनाएं भेजी जानी हैं.

फ़ीड

सूचनाओं की ऐसी कैटगरी जिसे पाने के लिए कोई ऐप्लिकेशन रजिस्टर कर सकता है. उदाहरण के लिए: "किसी डोमेन के लिए रोस्टर में सभी बदलाव".

जेएसओएन के काेड में दिखाना
{
  "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)

COURSE_ROSTER_CHANGES के feedType वाले Feed के बारे में जानकारी. अगर feedType COURSE_ROSTER_CHANGES है, तो यह फ़ील्ड तय करना ज़रूरी है.

courseWorkChangesInfo

object (CourseWorkChangesInfo)

COURSE_WORK_CHANGES के feedType वाले Feed के बारे में जानकारी. अगर feedType COURSE_WORK_CHANGES है, तो यह फ़ील्ड तय करना ज़रूरी है.

FeedType

एक तरह का फ़ीड जिससे कोई ऐप्लिकेशन सूचनाओं के लिए रजिस्टर कर सकता है.

Enums
FEED_TYPE_UNSPECIFIED इसे न तो लौटाया जाना चाहिए और न ही देना चाहिए.
DOMAIN_ROSTER_CHANGES

किसी खास डोमेन के लिए, नामावली में होने वाले सभी बदलाव.

जब भी कोई उपयोगकर्ता किसी कोर्स में शामिल होगा या उसे छोड़ेगा, तब सूचनाएं जनरेट होंगी.

जब कोई न्योता बनाया जाता है या मिटाया जाता है, तो कोई सूचना जनरेट नहीं होगी. हालांकि, जब कोई उपयोगकर्ता न्योता स्वीकार करके किसी कोर्स में शामिल होगा, तब सूचनाएं जनरेट होंगी.

COURSE_ROSTER_CHANGES

किसी खास कोर्स के लिए सभी रोस्टर में बदलाव.

जब भी कोई उपयोगकर्ता किसी कोर्स में शामिल होगा या उसे छोड़ेगा, तब सूचनाएं जनरेट होंगी.

जब कोई न्योता बनाया जाता है या मिटाया जाता है, तो कोई सूचना जनरेट नहीं होगी. हालांकि, जब कोई उपयोगकर्ता न्योता स्वीकार करके किसी कोर्स में शामिल होगा, तब सूचनाएं जनरेट होंगी.

COURSE_WORK_CHANGES

किसी खास कोर्स के लिए सभी कोर्स वर्क गतिविधि.

CourseWork या StudentSubmission ऑब्जेक्ट के बनाए जाने या उसमें बदलाव किए जाने पर सूचनाएं जनरेट होंगी. जब कोई StudentSubmission ऑब्जेक्ट अपने पैरंट CourseWork ऑब्जेक्ट में बनाने या उसमें बदलाव करने के लिए बनाया जाए, तो कोई सूचना जनरेट नहीं होगी. हालांकि, CourseWork ऑब्जेक्ट के बनाने या उसमें बदलाव करने पर सूचना जनरेट होगी.

CourseRosterChangesInfo

COURSE_ROSTER_CHANGES के feedType वाले Feed के बारे में जानकारी.

जेएसओएन के काेड में दिखाना
{
  "courseId": string
}
फ़ील्ड
courseId

string

सदस्य बनने के लिए कोर्स का courseId जिनके लिए नामावली में बदलाव होते हैं.

CourseWorkChangesInfo

COURSE_WORK_CHANGES के feedType वाले Feed के बारे में जानकारी.

जेएसओएन के काेड में दिखाना
{
  "courseId": string
}
फ़ील्ड
courseId

string

काम करने के लिए सब्सक्राइब करने के लिए कोर्स का courseId बदल जाता है.

CloudPubsubTopic

Cloud Pub/Sub विषय के बारे में जानकारी.

सूचनाएं पाने के लिए रजिस्टर करने के लिए, विषय के मालिक को classroom-notifications@system.gserviceaccount.com को projects.topics.publish की अनुमति देनी होगी.

जेएसओएन के काेड में दिखाना
{
  "topicName": string
}
फ़ील्ड
topicName

string

Cloud Pub/Sub विषय का name फ़ील्ड.

तरीके

create

Registration बनाता है, ताकि Classroom में दिए गए feed से cloudPubSubTopic में दिए गए डेस्टिनेशन पर सूचनाएं भेजी जा सकें.

delete

Registration को मिटा देता है, जिससे Classroom उस Registration के लिए सूचनाएं नहीं भेज पाता.