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),

  // Union field details can be only one of the following:
  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  // End of list of possible types for union field details.
  "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)

इस कोर्स वर्क को बनाए जाने का टाइमस्टैंप.

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

यह RFC 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)

इस कोर्स वर्क में सबसे हाल में किए गए बदलाव का टाइमस्टैंप.

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

यह RFC 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)

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

यह RFC 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)

सिर्फ़ आउटपुट के लिए. इस रिसॉर्स को वापस पाने के लिए इस्तेमाल किए गए एपीआई का प्रीव्यू वर्शन.
यूनियन फ़ील्ड details. कोर्स के काम के किसी टाइप के बारे में ज़्यादा जानकारी. details इनमें से सिर्फ़ एक हो सकता है:
assignment

object (Assignment)

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

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

object (MultipleChoiceQuestion)

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

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