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)

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

कोर्सवर्क में 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)

ज़रूरी नहीं.

इस कोर्सवर्क में अटैच किए गए, सीखने के लक्ष्यों के रेफ़रंस. किसी कोर्सवर्क में, सीखने के ज़्यादा से ज़्यादा 10 लक्ष्य हो सकते हैं. यह फ़ील्ड सिर्फ़ तब भरा जाता है, जब सही previewVersion सेट किया गया हो.
किसी खास तरह के कोर्स वर्क के बारे में ज़्यादा जानकारी. यहां ऐसे फ़ील्ड की सूची दी गई है जो एक-दूसरे से अलग हैं. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
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

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