REST Resource: courses.announcements

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

एक शिक्षक ने कोर्स के छात्र-छात्राओं के लिए सूचना दी है

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

वह टाइमस्टैंप जब यह सूचना बनाई गई थी.

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

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

string (Timestamp format)

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

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

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

string (Timestamp format)

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

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

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