- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
ऐड-ऑन अटैचमेंट के सबमिशन से जुड़ा डेटा अपडेट करता है.
यह ज़रूरी है कि ऐड-ऑन, अटैचमेंट का मूल क्रिएटर हो. साथ ही, अटैचमेंट की वैल्यू के तौर पर, maxPoints
की पॉज़िटिव वैल्यू सेट की गई हो.
इस तरीके से ये गड़बड़ी कोड मिलते हैं:
- ऐक्सेस गड़बड़ियों के लिए
PERMISSION_DENIED
. INVALID_ARGUMENT
, अगर अनुरोध गलत तरीके से किया गया है.- पहचाने गए संसाधनों में से कोई एक मौजूद न होने पर,
NOT_FOUND
.
एचटीटीपी अनुरोध
PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}
यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
courseId |
ज़रूरी है. कोर्स का आइडेंटिफ़ायर. |
itemId |
उस सूचना, CourseWork या CourseWorkMaterial का आइडेंटिफ़ायर जिसके तहत अटैचमेंट अटैच किया गया है. यह फ़ील्ड ज़रूरी है, लेकिन पोस्ट आईडी से माइग्रेट करते समय इसे इस तरह मार्क नहीं किया गया है. |
attachmentId |
ज़रूरी है. अटैचमेंट का आइडेंटिफ़ायर. |
submissionId |
ज़रूरी है. छात्र/छात्रा के सबमिशन का आइडेंटिफ़ायर. |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
postId |
ज़रूरी नहीं. अब काम नहीं करता, इसके बजाय itemId का इस्तेमाल करें. |
updateMask |
ज़रूरी है. मास्क, जो बताता है कि अटैचमेंट के किन फ़ील्ड को अपडेट करना है. अमान्य फ़ील्ड दिए गए हैं, तो अपडेट नहीं हो पाता. अगर किसी फ़ील्ड में खाली वैल्यू काम करती है, तो उसे अपडेट मास्क में तय करके साफ़ किया जा सकता है, न कि नीचे दिए गए फ़ील्ड को शिक्षक तय कर सकते हैं:
यह फ़ील्ड के पूरी तरह क्वालिफ़ाइड नामों की कॉमा-सेपरेटेड लिस्ट है. उदाहरण: |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य भाग में AddOnAttachmentStudentSubmission
का उदाहरण है.
जवाब का मुख्य भाग
कामयाब रहने पर, जवाब के मुख्य हिस्से में AddOnAttachmentStudentSubmission
का एक इंस्टेंस शामिल किया जाता है.
अनुमति देने के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/classroom.addons.teacher
ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.