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

updateTime

string (Timestamp format)

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

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

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

scheduledTime

string (Timestamp format)

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

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

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