Method: courses.updateGradingPeriodSettings

किसी कोर्स के ग्रेडिंग पीरियड की सेटिंग अपडेट करता है.

इस तरीके का इस्तेमाल करके, ग्रेड देने की अलग-अलग अवधियों को जोड़ा, हटाया या उनमें बदलाव किया जा सकता है.

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

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

  • PERMISSION_DENIED अगर अनुरोध करने वाले उपयोगकर्ता को किसी कोर्स में ग्रेड देने की अवधि की सेटिंग में बदलाव करने की अनुमति नहीं है या ऐक्सेस से जुड़ी गड़बड़ियों की वजह से:
    • UserIneligibleToUpdateGradingPeriodSettings
  • INVALID_ARGUMENT अगर अनुरोध गलत है.
  • NOT_FOUND अगर अनुरोध किया गया कोर्स मौजूद नहीं है.

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

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/gradingPeriodSettings

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

पाथ पैरामीटर

पैरामीटर
courseId

string

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

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

पैरामीटर
updateMask

string (FieldMask format)

मास्क, जो यह बताता है कि GradingPeriodSettings में कौनसे फ़ील्ड अपडेट करने हैं.

GradingPeriodSettings gradingPeriods सूची को, अपडेट के अनुरोध में बताई गई ग्रेडिंग अवधियों से पूरी तरह बदल दिया जाएगा. उदाहरण के लिए:

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

इन फ़ील्ड की जानकारी दी जा सकती है:

  • gradingPeriods
  • applyToExistingCoursework

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

enum (PreviewVersion)

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

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

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

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

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

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

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

  • https://www.googleapis.com/auth/classroom.courses

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