Method: courses.courseWork.rubrics.patch

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

किन फ़ील्ड को अपडेट किया जा सकता है, इसकी जानकारी के लिए google.classroom.v1.Rubric देखें. ग्रेड देने की प्रोसेस शुरू होने के बाद, रूब्रिक में बदलाव करने की सुविधाएं सीमित हो जाती हैं.

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

यह अनुरोध, Google Cloud Console में उस OAuth क्लाइंट आईडी से किया जाना चाहिए जिसका इस्तेमाल, पैरंट कोर्स वर्क आइटम बनाने के लिए किया गया था.

इस तरीके से, गड़बड़ी के ये कोड मिलते हैं:

  • PERMISSION_DENIED अगर अनुरोध करने वाले डेवलपर प्रोजेक्ट ने उससे जुड़ा कोर्स वर्क नहीं बनाया है, अगर उपयोगकर्ता के पास रूब्रिक में अनुरोध किया गया बदलाव करने की अनुमति नहीं है या ऐक्सेस से जुड़ी गड़बड़ियों की वजह से. अगर ग्रेडिंग की प्रोसेस पहले से ही शुरू हो चुकी है, तो भी गड़बड़ी का यह कोड दिखता है.
  • INVALID_ARGUMENT अगर अनुरोध गलत है और अनुरोध से जुड़ी इस गड़बड़ी के लिए:
    • RubricCriteriaInvalidFormat
  • NOT_FOUND अगर अनुरोध किया गया कोर्स, कोर्स वर्क या रूब्रिक मौजूद नहीं है या उपयोगकर्ता के पास उससे जुड़े कोर्स वर्क का ऐक्सेस नहीं है.
  • INTERNAL अगर रूब्रिक पर ग्रेडिंग पहले से शुरू हो चुकी है.

एचटीटीपी अनुरोध

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}

यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.

पाथ पैरामीटर

पैरामीटर
courseId

string

ज़रूरी है. कोर्स का आइडेंटिफ़ायर.
courseWorkId

string

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

string

ज़रूरी नहीं. रूब्रिक का आइडेंटिफ़ायर.

क्वेरी पैरामीटर

पैरामीटर
updateMask

string (FieldMask format)

ज़रूरी नहीं. मास्क, जो यह बताता है कि रूब्रिक के किन फ़ील्ड को अपडेट करना है. अपडेट करने के लिए, यह फ़ील्ड भरना ज़रूरी है. अमान्य फ़ील्ड की जानकारी देने पर, अपडेट नहीं हो पाता. किसी रूब्रिक की शर्तें तय करने के लिए, कई विकल्प हैं: sourceSpreadsheetId और criteria सूची. किसी रूब्रिक को तय करने के लिए, एक बार में इनमें से सिर्फ़ एक का इस्तेमाल किया जा सकता है.

अपडेट के अनुरोध में बताई गई रूब्रिक की शर्तों से, रूब्रिक criteria की सूची पूरी तरह से बदल जाती है. उदाहरण के लिए, अगर अनुरोध में कोई शर्त या लेवल मौजूद नहीं है, तो उसे मिटा दिया जाता है. नई शर्तें और लेवल जोड़े जाते हैं. साथ ही, एक आईडी असाइन किया जाता है. अगर अनुरोध में आईडी दिया गया है, तो मौजूदा शर्तों और लेवल में पहले से असाइन किया गया आईडी बना रहता है.

शिक्षक इन फ़ील्ड की जानकारी दे सकते हैं:

  • criteria
  • sourceSpreadsheetId

यह फ़ील्ड के पूरी तरह से क्वालिफ़ाइड नामों की सूची है. इसमें नामों को कॉमा लगाकर अलग किया गया है. उदाहरण: "user.displayName,photo".
previewVersion

enum (PreviewVersion)

ज़रूरी नहीं. एपीआई का झलक वाला वर्शन. झलक देखने की सुविधा वाले प्रोग्राम में डेवलपर के लिए उपलब्ध एपीआई की नई सुविधाओं को ऐक्सेस करने के लिए, यह सेट करना ज़रूरी है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में Rubric का उदाहरण है.

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में Rubric का एक इंस्टेंस शामिल किया जाता है.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/classroom.coursework.students

ज़्यादा जानकारी के लिए, अनुमति से जुड़ी गाइड देखें.