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