Method: courses.courseWorkMaterials.addOnAttachments.create

पोस्ट के नीचे ऐड-ऑन अटैचमेंट बनाता है.

पोस्ट पर नए अटैचमेंट बनाने की अनुमति पाने के लिए ऐड-ऑन की ज़रूरत होती है.

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

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

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

POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments

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

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

पैरामीटर
courseId

string

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

string

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

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

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

string

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

string

ज़रूरी नहीं. अनुरोध को अनुमति देने वाला टोकन.

जब उपयोगकर्ता को Classroom से ऐड-ऑन के यूआरएल पर रीडायरेक्ट किया जाता है, तो टोकन को क्वेरी पैरामीटर के तौर पर पास किया जाता है.

Classroom में अटैचमेंट बनाने के लिए, इस अनुमति टोकन की ज़रूरत होती है. हालांकि, पार्टनर-फ़र्स्ट अटैचमेंट बनाने के लिए इसका इस्तेमाल करना ज़रूरी नहीं है. पार्टनर-फ़र्स्ट अटैचमेंट बनाने के लिए इस फ़ील्ड को उपलब्ध न कराने पर गड़बड़ी दिखाता है. इसके अलावा, अगर अटैचमेंट बनाने वाले डेवलपर प्रोजेक्ट और इसके पैरंट स्ट्रीम आइटम मेल नहीं खाते हैं, तो गड़बड़ी का मैसेज दिखता है.

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

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

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

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

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

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

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

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