Method: courses.updateGradingPeriodSettings

• एचटीटीपी अनुरोध
• पाथ पैरामीटर
• क्वेरी पैरामीटर
• अनुरोध का मुख्य हिस्सा
• जवाब का मुख्य हिस्सा
• अनुमति पाने के लिंक

डेवलपर के लिए झलक: यह Google Workspace के डेवलपर के लिए झलक वाले प्रोग्राम के तहत उपलब्ध है. इस प्रोग्राम में, कुछ सुविधाओं को रिलीज़ होने से पहले इस्तेमाल करने का ऐक्सेस मिलता है. यह सुविधा V1_20240401_PREVIEW और उसके बाद के वर्शन में उपलब्ध है. ज़्यादा जानने के लिए, झलक देखने के लिए एपीआई ऐक्सेस करें देखें.

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

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

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

• 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

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