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)

अन्य कॉन्टेंट.

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

enum (CourseWorkState)

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

string (Timestamp format)

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

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

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

string (Timestamp format)

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

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

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

object (Date)

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

object (TimeOfDay)

यूटीसी में, दिन का वह समय जब इस कोर्स के लिए सबमिशन जमा करने की समयसीमा खत्म हो जाती है. यह जानकारी देना ज़रूरी नहीं है. अगर dueDate की वैल्यू दी गई है, तो इसकी वैल्यू भी देनी होगी.
scheduledTime

string (Timestamp format)

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

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

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