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

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