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

updateTime

string (Timestamp format)

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

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

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

dueDate

object (Date)

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

dueTime

object (TimeOfDay)

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

scheduledTime

string (Timestamp format)

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

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

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