REST Resource: courses.courseWorkMaterials

रिसॉर्स: CourseWorkMaterial

कोर्स के छात्र-छात्राओं के लिए, शिक्षक की ओर से बनाया गया कोर्स वर्क मटीरियल

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

string

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

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

string

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

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

string

इस कोर्स वर्क मटीरियल का टाइटल. टाइटल, मान्य UTF-8 स्ट्रिंग होनी चाहिए. इसमें 1 से 3,000 वर्ण होने चाहिए.
description

string

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

object (Material)

अतिरिक्त मटीरियल.

किसी कोर्स वर्क मटीरियल में, 20 से ज़्यादा मटीरियल आइटम नहीं होने चाहिए.
state

enum (CourseWorkMaterialState)

इस कोर्स वर्क मटीरियल का स्टेटस. अगर कोई स्टेटस तय नहीं किया जाता है, तो डिफ़ॉल्ट रूप से इसका स्टेटस 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

उस उपयोगकर्ता का आइडेंटिफ़ायर जिसने कोर्स वर्क मटीरियल बनाया है.

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

string

उस विषय का आइडेंटिफ़ायर जिससे यह कोर्स वर्क मटीरियल जुड़ा है. यह कोर्स में मौजूद किसी विषय से मेल खाना चाहिए.
learningGoals[]

object (LearningGoal)

ज़रूरी नहीं.

इस कोर्स वर्क मटीरियल से जुड़े, सीखने के लक्ष्यों के रेफ़रंस. CourseWorkMaterial में, सीखने के ज़्यादा से ज़्यादा 10 लक्ष्य हो सकते हैं. यह फ़ील्ड सिर्फ़ तब भरा जाता है, जब सही previewVersion सेट किया जाता है.

CourseWorkMaterialState

कोर्स वर्क मटीरियल के संभावित स्टेटस

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

तरीके

create

 कोर्स वर्क मटीरियल बनाता है.

delete

 कोर्स वर्क मटीरियल मिटाता है.

get

 कोर्स वर्क मटीरियल दिखाता है.

getAddOnContext

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

list

 कोर्स वर्क मटीरियल की सूची दिखाता है. इसे देखने की अनुमति अनुरोध करने वाले के पास होती है.

patch

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