Method: courses.updateGradingPeriodSettings

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

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

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

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

इस तरीके से गड़बड़ी के ये कोड दिखते हैं:

• 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

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