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

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