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".
यूनियन फ़ील्ड 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)

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 के बारे में जानकारी.

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

string

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

CourseWorkChangesInfo

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

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

string

जिस कोर्स के लिए आपको सूचनाएं चाहिए उसका courseId.

CloudPubsubTopic

Cloud Pub/Sub के विषय का रेफ़रंस.

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

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

string

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

तरीके

create

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

delete

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