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)

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

जवाब का मुख्य हिस्सा

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

अनुमति पाने के लिंक

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

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

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