लागू करने की रणनीति

इस पेज पर, आपके ऐड-ऑन वेब ऐप्लिकेशन और Google Classroom के ऐड-ऑन एपीआई के बीच होने वाले मुख्य इंटरैक्शन के बारे में खास जानकारी दी गई है.

अटैचमेंट डिस्कवरी iframe

अटैचमेंट डिस्कवरी iframe, आपके ऐड-ऑन में शिक्षकों के लिए लैंडिंग पेज होता है. इस व्यू के लिए, ये कार्रवाइयां करें:

  • कॉन्टेंट खोजने या बनाने के यूज़र इंटरफ़ेस (यूआई) को दिखाएं.

    इसके अलावा, यह भी तय किया जा सकता है कि स्ट्रीम आइटम में छात्र-छात्राओं के जवाब शामिल किए जाएंगे या नहीं. ऐसा इसलिए, ताकि शिक्षक गतिविधि से जुड़े अटैचमेंट न जोड़ सकें. उस itemType क्वेरी पैरामीटर की वैल्यू देखें जो ऐड-ऑन के iframed खुलने पर पास किया गया था. सिर्फ़ courseWork टाइप में, छात्र-छात्राओं के जवाब स्वीकार किए जाते हैं.

  • शिक्षक के चुने गए विकल्पों के आधार पर, असाइनमेंट में अटैचमेंट जोड़ने के लिए, एक या उससे ज़्यादा ऐड-ऑन create अनुरोध करें.

अन्य iframe

छात्र/छात्रा व्यू iframe, छात्र/छात्रा के काम की समीक्षा करने वाला iframe, और शिक्षक व्यू iframe, सभी का मकसद Classroom असाइनमेंट में बदलाव करने के बजाय, उपयोगकर्ता को कॉन्टेंट दिखाना है. इन व्यू के लिए, ये कार्रवाइयां करें:

  • जब कोई iframe खुलता है, तो उपयोगकर्ता की OAuth सहमति पाएं. इसके बाद, उसकी भूमिका और अटैचमेंट आईडी की पुष्टि करें.
  • जब कोई iframe खुलता है, तो उपयोगकर्ता की भूमिका की पुष्टि करने के लिए, itemType के आधार पर courseWork.GetAddOnContextRequest, courseWorkMaterials.GetAddOnContextRequest या announcements.GetAddOnContextRequest बनाएं.
  • अगर मौजूदा उपयोगकर्ता छात्र/छात्रा है, तो जवाब में मौजूद submissionId को छात्र/छात्राओं के काम से जोड़ें. ग्रेड वापस भेजने और ग्रेडिंग टूल में शिक्षकों को छात्र-छात्राओं का काम दिखाने के लिए, यह ज़रूरी है. submissionIds सभी व्यू में मैच करता है.
  • अगर ऐड-ऑन को attachmentId के बारे में पहले से पता है, तो अटैचमेंट का सही यूज़र इंटरफ़ेस (यूआई) दिखाएं.
  • अगर ऐसा नहीं है, तो हो सकता है कि इस अटैचमेंट की मुख्य पोस्ट को किसी दूसरी पोस्ट या कोर्स से कॉपी किया गया हो. copyHistory का इस्तेमाल करके, उस सबसे नई कॉपी की पहचान करें जिसकी जानकारी ऐड-ऑन के पास है. साथ ही, उससे सेटिंग कॉपी करके, ऐड-ऑन की ओर से अटैचमेंट का नया मॉडल बनाएं. इसके बाद, अटैचमेंट का सही यूज़र इंटरफ़ेस (यूआई) दिखाएं.