REST Resource: courses.announcements

संसाधन: सूचना

कोर्स के छात्र-छात्राओं के लिए शिक्षक की ओर से बनाई गई सूचना

JSON के काेड में दिखाना
{
  "courseId": string,
  "id": string,
  "text": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (AnnouncementState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "scheduledTime": string,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "creatorUserId": string
}
फ़ील्ड
courseId

string

कोर्स का आइडेंटिफ़ायर.

सिर्फ़ पढ़ने के लिए.

id

string

Classroom की ओर से इस सूचना को असाइन किया गया आइडेंटिफ़ायर, जो हर कोर्स के लिए यूनीक होता है.

सिर्फ़ पढ़ने के लिए.

text

string

इस सूचना का ब्यौरा. टेक्स्ट, UTF-8 में लिखी गई मान्य स्ट्रिंग होनी चाहिए. इसमें 30,000 से ज़्यादा वर्ण नहीं होने चाहिए.

materials[]

object (Material)

अन्य कॉन्टेंट.

सूचनाओं में 20 से ज़्यादा कॉन्टेंट आइटम नहीं होने चाहिए.

state

enum (AnnouncementState)

इस सूचना की स्थिति. अगर कोई वैल्यू तय नहीं की गई है, तो डिफ़ॉल्ट वैल्यू DRAFT होती है.

creationTime

string (Timestamp format)

इस एलान को बनाने का टाइमस्टैंप.

सिर्फ़ पढ़ने के लिए.

आरएफ़सी 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".

updateTime

string (Timestamp format)

इस एलान में किए गए सबसे हाल के बदलाव का टाइमस्टैंप.

सिर्फ़ पढ़ने के लिए.

आरएफ़सी 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".

scheduledTime

string (Timestamp format)

इस एलान को पब्लिश करने के लिए शेड्यूल किए गए समय का टाइमस्टैंप. यह ज़रूरी नहीं है.

आरएफ़सी 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".

assigneeMode

enum (AssigneeMode)

सूचना के लिए असाइनी मोड. अगर कोई वैल्यू तय नहीं की गई है, तो डिफ़ॉल्ट वैल्यू ALL_STUDENTS होती है.

individualStudentsOptions

object (IndividualStudentsOptions)

सूचना का ऐक्सेस रखने वाले छात्र-छात्राओं के आइडेंटिफ़ायर. यह फ़ील्ड सिर्फ़ तब सेट होता है, जब assigneeMode की वैल्यू INDIVIDUAL_STUDENTS हो. अगर assigneeMode INDIVIDUAL_STUDENTS है, तो सिर्फ़ इस फ़ील्ड में बताए गए छात्र-छात्राएं ही सूचना देख सकते हैं.

creatorUserId

string

सूचना बनाने वाले उपयोगकर्ता का आइडेंटिफ़ायर.

सिर्फ़ पढ़ने के लिए.

AnnouncementState

सूचनाओं की संभावित स्थितियां

Enums
ANNOUNCEMENT_STATE_UNSPECIFIED कोई राज्य नहीं चुना गया है. इसे कभी वापस नहीं किया जाता.
PUBLISHED पब्लिश की गई सूचना का स्टेटस. यह डिफ़ॉल्ट स्थिति है.
DRAFT किसी ऐसे एलान का स्टेटस जिसे अब तक पब्लिश नहीं किया गया है. इस स्थिति में, एलान सिर्फ़ कोर्स के शिक्षकों और डोमेन एडमिन को दिखता है.
DELETED पब्लिश की गई सूचना का स्टेटस, जिसे अब मिटा दिया गया है. इस स्थिति में, एलान सिर्फ़ कोर्स के शिक्षकों और डोमेन एडमिन को दिखता है. इस स्थिति में मौजूद सूचना कुछ समय बाद मिटा दी जाती है.

तरीके

create

सूचना बनाता है.

delete

किसी सूचना को मिटाता है.

get

कोई सूचना दिखाता है.

getAddOnContext

किसी खास पोस्ट के संदर्भ में, Classroom के ऐड-ऑन का मेटाडेटा पाता है.

list

उन सूचनाओं की सूची दिखाता है जिन्हें देखने की अनुमति अनुरोध करने वाले व्यक्ति को है.

modifyAssignees

यह किसी सूचना के लिए, असाइनी मोड और विकल्पों में बदलाव करता है.

patch

किसी सूचना के एक या उससे ज़्यादा फ़ील्ड को अपडेट करता है.