REST Resource: courses.courseWork.rubrics

संसाधन: रूब्रिक

कोर्स वर्क का रूब्रिक. रूब्रिक, स्कोर देने की एक गाइड है. इसका इस्तेमाल, छात्र-छात्राओं के काम का आकलन करने और उन्हें फ़ीडबैक देने के लिए किया जाता है.

ज़्यादा जानकारी के लिए, रूब्रिक का स्ट्रक्चर और इसकी सीमाएं लेख पढ़ें.

JSON के काेड में दिखाना
{
  "courseId": string,
  "courseWorkId": string,
  "id": string,
  "creationTime": string,
  "updateTime": string,
  "criteria": [
    {
      object (Criterion)
    }
  ],
  "previewVersion": enum (PreviewVersion),

  "sourceSpreadsheetId": string
}
फ़ील्ड
courseId

string

कोर्स का आइडेंटिफ़ायर.

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

courseWorkId

string

कोर्सवर्क का आइडेंटिफ़ायर, जिससे यह जुड़ा है.

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

id

string

Classroom से असाइन किया गया रूब्रिक का आइडेंटिफ़ायर. यह रूब्रिक, कोर्सवर्क के लिए बनाए गए अन्य रूब्रिक से अलग होता है.

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

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".

criteria[]

object (Criterion)

शर्तों की सूची. हर शर्त एक डाइमेंशन है, जिसके आधार पर परफ़ॉर्मेंस को रेटिंग दी जाती है.

previewVersion

enum (PreviewVersion)

सिर्फ़ आउटपुट के लिए. इस संसाधन को वापस पाने के लिए, एपीआई के वर्शन की झलक का इस्तेमाल किया गया.

किसी मौजूदा सोर्स से रूब्रिक बनाने के विकल्प. यहां ऐसे फ़ील्ड की सूची दी गई है जो एक-दूसरे से अलग हैं. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
sourceSpreadsheetId

string

सिर्फ़ इनपुट के लिए. इम्यूटेबल. स्प्रेडशीट का Google Sheets आईडी. इस स्प्रेडशीट में, फ़ॉर्मैट की गई रूब्रिक सेटिंग होनी चाहिए. किसी असाइनमेंट के लिए रूब्रिक बनाना या पुराने रूब्रिक का इस्तेमाल करना लेख पढ़ें. इस फ़ील्ड का इस्तेमाल करने के लिए, https://www.googleapis.com/auth/spreadsheets.readonly या https://www.googleapis.com/auth/spreadsheets स्कोप की ज़रूरत होती है.

एक-दूसरे से अलग फ़ील्ड का अंत.

मानदंड

रूब्रिक का मानदंड. हर शर्त एक डाइमेंशन है, जिसके आधार पर परफ़ॉर्मेंस को रेटिंग दी जाती है.

JSON के काेड में दिखाना
{
  "id": string,
  "title": string,
  "description": string,
  "levels": [
    {
      object (Level)
    }
  ],
  "learningGoal": {
    object (LearningGoal)
  }
}
फ़ील्ड
id

string

मानदंड आईडी.

इसे बनाते समय, एक आईडी असाइन किया जाता है.

title

string

मापदंड का टाइटल.

description

string

शर्त का ब्यौरा.

levels[]

object (Level)

इस शर्त के तहत आने वाले लेवल की सूची.

learningGoal

object (LearningGoal)

ज़रूरी नहीं.

इस मानदंड से जुड़ा, सीखने का लक्ष्य. ध्यान दें कि रूब्रिक के मानदंड से अटैच किए गए सीखने के लक्ष्य, उस असाइनमेंट से पहले ही अटैच होने चाहिए जिससे रूब्रिक लिंक किया गया है. यह फ़ील्ड सिर्फ़ तब भरा जाता है, जब सही previewVersion सेट किया गया हो.

लेवल

मापदंड का एक लेवल.

JSON के काेड में दिखाना
{
  "id": string,
  "title": string,
  "description": string,
  "points": number
}
फ़ील्ड
id

string

लेवल का आईडी.

इसे बनाते समय, एक आईडी असाइन किया जाता है.

title

string

लेवल का टाइटल.

अगर लेवल के लिए कोई पॉइंट सेट नहीं किया गया है, तो टाइटल सेट करना ज़रूरी है.

description

string

लेवल की जानकारी.

points

number

इस लेवल से जुड़े वैकल्पिक पॉइंट. अगर रूब्रिक सेट किया गया है, तो उसके सभी लेवल के लिए पॉइंट तय करना ज़रूरी है. साथ ही, किसी एक शर्त के सभी लेवल के लिए, पॉइंट की वैल्यू अलग-अलग होनी चाहिए. 0 और 'कोई पॉइंट नहीं' में अंतर होता है.

तरीके

create

रूब्रिक बनाता है.

delete

रूब्रिक मिटाता है.

get

कोई रूब्रिक दिखाता है.

list

इससे उन रूब्रिक की सूची मिलती है जिन्हें देखने की अनुमति अनुरोध करने वाले व्यक्ति के पास है.

patch

किसी रूब्रिक को अपडेट करता है.