Method: courses.courseWork.getAddOnContext

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

किसी खास पोस्ट के कॉन्टेक्स्ट के हिसाब से, Classroom ऐड-ऑन के लिए मेटाडेटा उपलब्ध कराता है.

अपने डेटा और अनुमतियों के मॉडल को बनाए रखने के लिए, ऐड-ऑन को इसे कॉल करना चाहिए, ताकि जब भी iframe में ऐड-ऑन खोला जाए, तब क्वेरी पैरामीटर और अनुरोध करने वाले उपयोगकर्ता की भूमिका की पुष्टि की जा सके.

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

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

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

GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{itemId}/addOnContext

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

पाथ पैरामीटर

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

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

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

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

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

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

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

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

इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

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

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