Method: courses.courseWork.studentSubmissions.patch

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

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

यह अनुरोध, उस OAuth क्लाइंट आईडी के Developer Console प्रोजेक्ट से किया जाना चाहिए जिसका इस्तेमाल कोर्स वर्क आइटम बनाने के लिए किया गया था.

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

  • 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

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