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 वाले कोर्सवर्क के लिए dueTime की वैल्यू सेट नहीं की गई है, तो तय तारीख पर कोर्सवर्क के dueTime की वैल्यू 23:59 पर सेट हो जाती है.
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)

ज़रूरी नहीं.

इस क्लासवर्क से जुड़े सीखने के लक्ष्यों के रेफ़रंस. CourseWork में, सीखने के ज़्यादा से ज़्यादा 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

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