REST Resource: registrations

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

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

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