Method: courses.courseWork.addOnAttachments.studentSubmissions.patch

ऐड-ऑन अटैचमेंट के सबमिशन से जुड़ा डेटा अपडेट करता है.

यह ज़रूरी है कि ऐड-ऑन, अटैचमेंट का मूल क्रिएटर हो. साथ ही, अटैचमेंट की वैल्यू के तौर पर, maxPoints की पॉज़िटिव वैल्यू सेट की गई हो.

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

  • ऐक्सेस गड़बड़ियों के लिए PERMISSION_DENIED.
  • INVALID_ARGUMENT, अगर अनुरोध गलत तरीके से किया गया है.
  • पहचाने गए संसाधनों में से कोई एक मौजूद न होने पर, NOT_FOUND.

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

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}

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

पाथ के पैरामीटर

पैरामीटर
courseId

string

ज़रूरी है. कोर्स का आइडेंटिफ़ायर.

itemId

string

उस सूचना, CourseWork या CourseWorkMaterial का आइडेंटिफ़ायर जिसके तहत अटैचमेंट अटैच किया गया है. यह फ़ील्ड ज़रूरी है, लेकिन पोस्ट आईडी से माइग्रेट करते समय इसे इस तरह मार्क नहीं किया गया है.

attachmentId

string

ज़रूरी है. अटैचमेंट का आइडेंटिफ़ायर.

submissionId

string

ज़रूरी है. छात्र/छात्रा के सबमिशन का आइडेंटिफ़ायर.

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

पैरामीटर
postId
(deprecated)

string

ज़रूरी नहीं. अब काम नहीं करता, इसके बजाय itemId का इस्तेमाल करें.

updateMask

string (FieldMask format)

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

नीचे दिए गए फ़ील्ड को शिक्षक तय कर सकते हैं:

  • pointsEarned

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

अनुरोध का मुख्य भाग

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

जवाब का मुख्य भाग

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

अनुमति देने के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/classroom.addons.teacher

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