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