किसी खास पोस्ट के संदर्भ में, Classroom के ऐड-ऑन का मेटाडेटा पाता है.
अपने डेटा और अनुमतियों के मॉडल को पूरी तरह से सुरक्षित रखने के लिए, किसी भी ऐड-ऑन को क्वेरी पैरामीटर और अनुरोध करने वाले उपयोगकर्ता की भूमिका की पुष्टि करने के लिए, इसे कॉल करना चाहिए. ऐसा तब करना चाहिए, जब ऐड-ऑन किसी iframe में खोला गया हो.
उस Announcement, CourseWork या CourseWorkMaterial का आइडेंटिफ़ायर जिससे अटैचमेंट जुड़ा है. इस फ़ील्ड को भरना ज़रूरी है. हालांकि, postId से माइग्रेट करने के दौरान, इसे ज़रूरी के तौर पर मार्क नहीं किया जाता.
क्वेरी पैरामीटर
पैरामीटर
postId (deprecated)
string
ज़रूरी नहीं. इसका इस्तेमाल बंद कर दिया गया है. इसके बजाय, itemId का इस्तेमाल करें.
addOnToken
string
ज़रूरी नहीं. अनुरोध को अनुमति देने वाला टोकन.
जब उपयोगकर्ता को Classroom से ऐड-ऑन के यूआरएल पर रीडायरेक्ट किया जाता है, तब टोकन को क्वेरी पैरामीटर के तौर पर पास किया जाता है.
अनुमति टोकन तब ज़रूरी होता है, जब इनमें से कोई भी शर्त पूरी न हो:
ऐड-ऑन में पोस्ट पर अटैचमेंट हैं.
अनुरोध करने वाला डेवलपर प्रोजेक्ट वही है जिसने पोस्ट बनाई है.
attachmentId
string
ज़रूरी नहीं. अटैचमेंट का आइडेंटिफ़ायर. यह फ़ील्ड सभी अनुरोधों के लिए ज़रूरी है. हालांकि, जब उपयोगकर्ता अटैचमेंट डिस्कवरी iframe में हो, तब यह ज़रूरी नहीं है.
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य हिस्सा
कामयाब रहने पर, जवाब के मुख्य हिस्से में AddOnContext का एक इंस्टेंस शामिल किया जाता है.
अनुमति के दायरे
इसके लिए, OAuth के इनमें से किसी एक स्कोप की ज़रूरत होती है:
[[["समझने में आसान है","easyToUnderstand","thumb-up"],["मेरी समस्या हल हो गई","solvedMyProblem","thumb-up"],["अन्य","otherUp","thumb-up"]],[["वह जानकारी मौजूद नहीं है जो मुझे चाहिए","missingTheInformationINeed","thumb-down"],["बहुत मुश्किल है / बहुत सारे चरण हैं","tooComplicatedTooManySteps","thumb-down"],["पुराना","outOfDate","thumb-down"],["अनुवाद से जुड़ी समस्या","translationIssue","thumb-down"],["सैंपल / कोड से जुड़ी समस्या","samplesCodeIssue","thumb-down"],["अन्य","otherDown","thumb-down"]],["आखिरी बार 2024-12-05 (UTC) को अपडेट किया गया."],[[["Retrieves metadata for Classroom add-ons within a specific post, validating user roles and query parameters."],["Requires `courseId`, `itemId` as path parameters, with optional query parameters like `addOnToken` and `attachmentId`."],["Returns an `AddOnContext` object upon successful execution, providing relevant add-on information."],["May return errors like `PERMISSION_DENIED`, `INVALID_ARGUMENT`, or `NOT_FOUND` depending on the context."],["Needs authorization with either `https://www.googleapis.com/auth/classroom.addons.student` or `https://www.googleapis.com/auth/classroom.addons.teacher` scope."]]],[]]
