Method: courses.courseWork.studentSubmissions.patch

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

किन फ़ील्ड को अपडेट किया जा सकता है और उन्हें कौन बदल सकता है, इस बारे में ज़्यादा जानने के लिए, google.classroom.v1.StudentSubmission देखें.

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

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

  • अगर अनुरोध करने वाले डेवलपर प्रोजेक्ट ने, कोर्स वर्क या ग्रेड सिंक की सुविधा चालू करके, कोर्स वर्क के आइटम से जोड़ा गया ऐड-ऑन अटैचमेंट नहीं बनाया है, तो PERMISSION_DENIED गड़बड़ी का कोड मिलेगा. इसके अलावा, अगर उपयोगकर्ता को छात्र-छात्रा के सबमिट किए गए असाइनमेंट में अनुरोध किया गया बदलाव करने की अनुमति नहीं है या ऐक्सेस से जुड़ी गड़बड़ियां होती हैं, तब भी यह कोड मिलेगा.
  • अगर अनुरोध का फ़ॉर्मैट सही नहीं है, तो INVALID_ARGUMENT गड़बड़ी का कोड मिलेगा.
  • अगर अनुरोध किया गया कोर्स, कोर्स वर्क या छात्र-छात्रा का सबमिट किया गया असाइनमेंट मौजूद नहीं है, तो NOT_FOUND गड़बड़ी का कोड मिलेगा.

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

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

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

पाथ पैरामीटर

पैरामीटर
courseId

string

कोर्स का आइडेंटिफ़ायर. यह आइडेंटिफ़ायर, Classroom से असाइन किया गया आइडेंटिफ़ायर या कोई alias हो सकता है.
courseWorkId

string

कोर्स वर्क का आइडेंटिफ़ायर.
id

string

छात्र-छात्रा के सबमिट किए गए असाइनमेंट का आइडेंटिफ़ायर.

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

पैरामीटर
updateMask

string (FieldMask format)

यह मास्क, छात्र-छात्रा के सबमिट किए गए असाइनमेंट के उन फ़ील्ड की पहचान करता है जिन्हें अपडेट करना है. अपडेट करने के लिए, यह फ़ील्ड ज़रूरी है. अगर अमान्य फ़ील्ड तय किए जाते हैं, तो अपडेट नहीं हो पाता.

शिक्षक, ये फ़ील्ड तय कर सकते हैं:

  • draftGrade
  • assignedGrade

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

enum (PreviewVersion)

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

अनुरोध का मुख्य हिस्सा

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

जवाब का मुख्य हिस्सा

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

अनुमति पाने के लिंक

इसके लिए, OAuth के इन दायरों में से किसी एक की ज़रूरत होती है:

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

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