Method: courses.courseWork.studentSubmissions.modifyAttachments

छात्र/छात्रा के सबमिशन के अटैचमेंट में बदलाव करता है.

अटैचमेंट सिर्फ़ उन कोर्स वर्क ऑब्जेक्ट से जुड़े छात्र-छात्राओं के सबमिशन में जोड़े जा सकते हैं जिनका workType ASSIGNMENT है.

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

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

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

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

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

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

पाथ पैरामीटर

पैरामीटर
courseId

string

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

string

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

string

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

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

अनुरोध के मुख्य भाग में, नीचे दिए गए स्ट्रक्चर वाला डेटा होता है:

JSON के काेड में दिखाना 
{
  "addAttachments": [
    {
      object (Attachment)
    }
  ],
  "previewVersion": enum (PreviewVersion)
}
फ़ील्ड
addAttachments[]

object (Attachment)

जोड़ने के लिए अटैचमेंट. छात्र/छात्रा के सबमिशन में 20 से ज़्यादा अटैचमेंट नहीं हो सकते.

Form अटैचमेंट काम नहीं करते.
previewVersion

enum (PreviewVersion)

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

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

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

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

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

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

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