REST Resource: courses.courseWork

संसाधन: CourseWork

कोर्स वर्क, जिसे शिक्षक ने कोर्स में शामिल छात्र-छात्राओं के लिए बनाया है.

JSON के काेड में दिखाना 
{
  "courseId": string,
  "id": string,
  "title": string,
  "description": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (CourseWorkState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "dueDate": {
    object (Date)
  },
  "dueTime": {
    object (TimeOfDay)
  },
  "scheduledTime": string,
  "maxPoints": number,
  "workType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "submissionModificationMode": enum (SubmissionModificationMode),
  "creatorUserId": string,
  "topicId": string,
  "gradeCategory": {
    object (GradeCategory)
  },
  "previewVersion": enum (PreviewVersion),
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ],

  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  "gradingPeriodId": string
}
फ़ील्ड
courseId

string

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

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

string

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

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

string

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

string

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

object (Material)

अतिरिक्त संसाधन.

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

enum (CourseWorkState)

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

object (Date)

यूटीसी में मौजूद वह तारीख (ज़रूरी नहीं), जब इस कोर्स के काम को सबमिट करना है. अगर dueTime की जानकारी दी गई है, तो यह जानकारी देना ज़रूरी है.
dueTime

object (TimeOfDay)

दिन का वह समय (यूटीसी में), जब इस कोर्स के काम को सबमिट करना ज़रूरी है. यह जानकारी देना ज़रूरी नहीं है. अगर dueDate की जानकारी दी गई है, तो यह जानकारी देना ज़रूरी है.
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".
maxPoints

number

इस कोर्स वर्क के लिए ज़्यादा से ज़्यादा ग्रेड. अगर यह वैल्यू शून्य है या इसे सेट नहीं किया गया है, तो इस असाइनमेंट को 'ग्रेड नहीं दिया गया' के तौर पर मार्क कर दिया जाता है. यह एक नॉन-नेगेटिव पूर्णांक वैल्यू होनी चाहिए.
workType

enum (CourseWorkType)

यह कोर्स वर्क किस तरह का है.

कोर्स वर्क बनाते समय टाइप सेट किया जाता है और इसे बदला नहीं जा सकता.
associatedWithDeveloper

boolean

यह कोर्स वर्क आइटम, अनुरोध करने वाले Developer Console प्रोजेक्ट से जुड़ा है या नहीं.

ज़्यादा जानकारी के लिए, courseWork.create पर जाएं.

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

enum (AssigneeMode)

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

object (IndividualStudentsOptions)

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

enum (SubmissionModificationMode)

यह सेटिंग यह तय करती है कि छात्र-छात्राओं को सबमिशन में बदलाव करने की अनुमति कब दी जाएगी. अगर कोई वैल्यू तय नहीं की गई है, तो डिफ़ॉल्ट वैल्यू MODIFIABLE_UNTIL_TURNED_IN होती है.
creatorUserId

string

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

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

string

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

object (GradeCategory)

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

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

enum (PreviewVersion)

सिर्फ़ आउटपुट के लिए. इस संसाधन को वापस पाने के लिए इस्तेमाल किए गए एपीआई का प्रीव्यू वर्शन.
learningGoals[]

object (LearningGoal)

ज़रूरी नहीं.

इस कोर्स वर्क से जुड़े किसी भी लर्निंग गोल के रेफ़रंस. यह फ़ील्ड सिर्फ़ तब दिखता है, जब PreviewVersion सही तरीके से सेट किया गया हो. कोर्स के काम में, ज़्यादा से ज़्यादा 10 लर्निंग गोल हो सकते हैं.
यूनियन फ़ील्ड details. कोर्स के काम के किसी टाइप के बारे में ज़्यादा जानकारी. details इनमें से सिर्फ़ एक हो सकता है:
assignment

object (Assignment)

असाइनमेंट की जानकारी. यह फ़ील्ड सिर्फ़ तब दिखता है, जब workType ASSIGNMENT हो.

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

object (MultipleChoiceQuestion)

कई विकल्पों वाले सवाल की जानकारी. रीड ऑपरेशन के लिए, यह फ़ील्ड सिर्फ़ तब भरा जाता है, जब workType MULTIPLE_CHOICE_QUESTION हो. लिखने की कार्रवाइयों के लिए, workType के MULTIPLE_CHOICE_QUESTION वाले कोर्स वर्क को बनाते समय, इस फ़ील्ड को तय करना ज़रूरी है. इसके अलावा, इसे सेट नहीं किया जाना चाहिए.
gradingPeriodId

string

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

  • अगर ग्रेडिंग पीरियड आईडी सेट नहीं किया गया है, तो इसे dueDate के आधार पर सेट किया जाएगा. अगर dueDate सेट नहीं किया गया है, तो इसे scheduledTime के आधार पर सेट किया जाएगा.
  • अगर किसी ग्रेडिंग पीरियड से कोई कोर्स नहीं जुड़ा है, तो इस फ़ील्ड को खाली स्ट्रिंग ("") पर सेट करें.
  • अगर इसे तय किया गया है, तो यह कोर्स में मौजूद ग्रेडिंग पीरियड के आईडी से मेल खाना चाहिए.

CourseWorkState

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

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

SubmissionModificationMode

छात्र-छात्राओं के सबमिट किए गए असाइनमेंट में बदलाव करने के तरीके.

Enums
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED बदलाव का कोई मोड नहीं दिया गया है. इसे कभी वापस नहीं किया जाता.
MODIFIABLE_UNTIL_TURNED_IN सबमिट करने से पहले, असाइनमेंट में बदलाव किया जा सकता है.
MODIFIABLE सबमिट किए गए डेटा में किसी भी समय बदलाव किया जा सकता है.

Assignment

असाइनमेंट के बारे में अतिरिक्त जानकारी.

JSON के काेड में दिखाना 
{
  "studentWorkFolder": {
    object (DriveFolder)
  }
}
फ़ील्ड
studentWorkFolder

object (DriveFolder)

Drive का वह फ़ोल्डर जिसमें छात्र-छात्राओं के सबमिट किए गए असाइनमेंट के अटैचमेंट रखे जाते हैं. यह जानकारी सिर्फ़ कोर्स के शिक्षकों और एडमिन के लिए अपने-आप भर जाती है.

MultipleChoiceQuestion

कई विकल्प वाले सवालों के लिए अतिरिक्त जानकारी.

JSON के काेड में दिखाना 
{
  "choices": [
    string
  ]
}
फ़ील्ड
choices[]

string

उपलब्ध विकल्प.

तरीके

create

 इसकी मदद से कोर्स वर्क बनाया जा सकता है.

delete

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

get

 कोर्स वर्क वापस करता है.

getAddOnContext

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

list

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

modifyAssignees

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

patch

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