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
}
फ़ील्ड
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

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

CourseWorkMaterialState

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

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

तरीके

create

कोर्स वर्क का कॉन्टेंट बनाता है.

delete

कोर्स के काम से जुड़ा कॉन्टेंट मिटाता है.

get

कोर्स के काम का कॉन्टेंट दिखाता है.

getAddOnContext

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

list

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

patch

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