Method: courses.announcements.addOnAttachments.create

• एचटीटीपी अनुरोध
• पाथ पैरामीटर
• क्वेरी पैरामीटर
• अनुरोध का मुख्य हिस्सा
• जवाब का मुख्य हिस्सा
• अनुमति पाने के लिंक

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

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

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

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

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

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

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

पाथ पैरामीटर

पैरामीटर
courseId	string ज़रूरी है. कोर्स का आइडेंटिफ़ायर.
itemId	string Announcement, CourseWork या CourseWorkMaterial का आइडेंटिफ़ायर, जिसके तहत अटैचमेंट बनाना है. यह फ़ील्ड भरना ज़रूरी है. हालांकि, postId से माइग्रेट करने के दौरान, इसे ज़रूरी के तौर पर मार्क नहीं किया जाता.

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

पैरामीटर
postId (deprecated)	string ज़रूरी नहीं. इसका इस्तेमाल बंद कर दिया गया है. इसके बजाय, itemId का इस्तेमाल करें.
addOnToken	string ज़रूरी नहीं. अनुरोध को अनुमति देने वाला टोकन. जब उपयोगकर्ता को Classroom से ऐड-ऑन के यूआरएल पर रीडायरेक्ट किया जाता है, तब टोकन को क्वेरी पैरामीटर के तौर पर पास किया जाता है. Classroom में अटैचमेंट बनाने के लिए, अनुमति वाला यह टोकन ज़रूरी है. हालांकि, पार्टनर के लिए पहले से अटैचमेंट बनाने के लिए, यह टोकन ज़रूरी नहीं है. अगर पार्टनर के लिए अटैचमेंट बनाने के लिए यह पैरामीटर नहीं दिया गया है और अटैचमेंट बनाने वाले डेवलपर प्रोजेक्ट और उसके पैरंट स्ट्रीम आइटम का नाम मेल नहीं खाता है, तो गड़बड़ी का मैसेज दिखता है.

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

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

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

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

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

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

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

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