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 लागू रहेगा.

यह सर्वर से असाइन किया गया रीड-ओनली फ़ील्ड है.

आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: "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)

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 के लिए सूचनाएं भेजना बंद कर देता है.