लिंक अटैचमेंट को Classroom ऐड-ऑन अटैचमेंट में अपग्रेड करना

शिक्षक, Classroom में तीसरे पक्ष का कॉन्टेंट जोड़ सकते हैं. इसके लिए: असाइनमेंट बनाने वाले पेज में लिंक को लिंक अटैचमेंट के तौर पर चिपकाकर. बनाने के लिए शिक्षकों के पास पहले से मौजूद जानकारी होती है. अब आपके पास अपने ऐड-ऑन को शिक्षकों को लिंक वाले अटैचमेंट को ऐड-ऑन अटैचमेंट में अपग्रेड करने की सुविधा देनी होगी.

खास जानकारी

अगर ऐड-ऑन को इस सुविधा के साथ कॉन्फ़िगर किया जाता है, तो शिक्षकों को निर्देश देने के लिए कहा जाता है किसी लिंक अटैचमेंट को असाइनमेंट बनाने वाले पेज पर जाएं. शिक्षकों को ऐसा करने के लिए सिर्फ़ तब कहा जाता है, जब वे पहले से ही ऐड-ऑन इंस्टॉल करना होगा.

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

  • courseId
  • itemId
  • itemType
  • addOnToken
  • urlToUpgrade
  • login_hint (सिर्फ़ तब, जब उपयोगकर्ता ने आपके ऐप्लिकेशन को पहले ही अनुमति दे दी हो)

पहले चार क्वेरी पैरामीटर, अटैचमेंट डिस्कवरी iframe. urlToUpgrade क्वेरी पैरामीटर नया है और यह कर सकता है ऐड-ऑन अटैचमेंट बनाने के तरीके का आकलन करने में आपकी मदद कर सकते हैं. इसके बाद, अगर आपको दूसरे क्वेरी पैरामीटर, ताकि यह पता लगाया जा सके कि उपयोगकर्ता ने साइन-इन किया है या नहीं. इसके बाद, courseWork, courseWorkMaterials या में से CreateAddOnAttachment तरीका itemType वैल्यू के आधार पर announcements. iframe में, ये काम किए जा सकते हैं एक लोडिंग स्क्रीन दिखाएं, ताकि शिक्षक को बताया जा सके कि ऐड-ऑन अटैचमेंट बनाया जा रहा है.

ऐड-ऑन अटैचमेंट बन जाने के बाद, iframe बंद हो जाता है और शिक्षक असाइनमेंट में अटैचमेंट को उसी तरह देख सकते हैं जैसे वे आम तौर पर देखते हैं.

तकनीकी तौर पर लागू करने से जुड़ी जानकारी

इस सेक्शन में, सुविधा की अहम तकनीकी जानकारी को हाइलाइट किया गया है.

urlToUpgrade क्वेरी पैरामीटर को पढ़ें

urlToUpgrade क्वेरी पैरामीटर को यूआरआई कोड में बदला जाता है, जब इसे लिंक पर पास किया जाता है iframe अपग्रेड करें. यूआरएल को उसके ओरिजनल फ़ॉर्मैट में पाने के लिए, आपको उसे डिकोड करना होगा. अगर आपने आप JavaScript का इस्तेमाल कर रहे हैं, उदाहरण के लिए, आप decodeURIComponent() का इस्तेमाल कर सकते हैं उस विकल्प का इस्तेमाल किया जाता है.

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

कॉन्फ़िगरेशन की जानकारी

इस सुविधा को अपने ऐड-ऑन:

  • लिंक अपग्रेड iframe का यूआरएल: यह वह यूआरएल है जो iframe जब कोई शिक्षक अपग्रेड करने के लिए सहमत होता है.

  • ऐसे यूआरएल पैटर्न जिनका इस्तेमाल Classroom को करना चाहिए और जिनकी कोशिश करनी चाहिए अपग्रेड: यूआरएल पैटर्न में एक होस्ट और एक से ज़्यादा पाथ शामिल हो सकते हैं प्रीफ़िक्स हैं.

    • एक से ज़्यादा यूआरएल पैटर्न दिए जा सकते हैं.
    • अगर पाथ के प्रीफ़िक्स नहीं दिए गए हैं, तो होस्ट से मेल खाने वाला कोई भी यूआरएल को अपग्रेड किया जा सकता है.
    • सिर्फ़ https स्कीम वाले यूआरएल अपग्रेड किए जा सकते हैं.
    • यूआरएल पैटर्न में localhost नहीं होना चाहिए.
    • पाथ के प्रीफ़िक्स में क्वेरी पैरामीटर या यूआरएल फ़्रैगमेंट नहीं होने चाहिए.
    • फ़िलहाल, पाथ प्रीफ़िक्स वाइल्डकार्ड के साथ काम कर सकते हैं, लेकिन होस्ट ये काम नहीं कर सकते:
      • example.com एक मान्य होस्ट है, और /foo और /bar/*/baz मान्य पाथ प्रीफ़िक्स हैं.
      • example.*.host.com मान्य होस्ट.
    • पाथ प्रीफ़िक्स कॉम्पोनेंट के बीच मौजूद वाइल्डकार्ड, सिर्फ़ एक सिंगल से मैच करता है कॉम्पोनेंट से मेल नहीं खाता. यह स्लैश से अलग किए गए कई कॉम्पोनेंट से मेल नहीं खाता. होस्ट example.com और पाथ प्रीफ़िक्स के साथ यूआरएल पैटर्न का इस्तेमाल करें /bar/*/baz:
      • को दबाकर रखें यूआरएल के लिए https://example.com/bar/123/baz मान्य है पैटर्न.
      • को दबाकर रखें https://example.com/bar/123/baz/456/789 इसके लिए मान्य है: यूआरएल पैटर्न.
      • को दबाकर रखें https://example.com/bar/123/456/baz इसके लिए मान्य मिलान नहीं है यूआरएल पैटर्न, क्योंकि पाथ के प्रीफ़िक्स में मौजूद वाइल्डकार्ड मेल नहीं खाता /123/456/.

डेवलपमेंट प्रोसेस

अपने टेस्ट या प्रोडक्शन के लिए, लिंक अपग्रेड iframe यूआरएल और यूआरएल पैटर्न भेजें classroom-link-upgrade-external@google.com पर ईमेल करके ऐड-ऑन पाएं.

आपके पास ऐसे किसी भी Google Cloud प्रोजेक्ट के लिए कॉन्फ़िगरेशन उपलब्ध कराने का विकल्प होता है जो Classroom ऐड-ऑन. हमारी सलाह है कि आप पहले निजी विज़िबिलिटी वाले ऐड-ऑन के लिए कॉन्फ़िगरेशन, ताकि आप इसे डेवलप कर सकें और लाइव उपयोगकर्ताओं को प्रभावित किए बिना डेमो डोमेन में टेस्ट कर सकते हैं.

कॉन्फ़िगरेशन पूरा हो जाने के बाद, आपको ईमेल पर जवाब मिलेगा चालू किया गया. ध्यान दें कि localhost का इस्तेमाल करने वाले यूआरएल पैटर्न इसके लिए काम नहीं करते सुविधा.

ईमेल को फ़ॉर्मैट करें, ताकि इसमें इन्हें शामिल किया जा सके:

Google Cloud Project number: GCP_PROJECT_NUMBER

Link Upgrade iframe URL: LINK_UPGRADE_IFRAME_URL

URL Patterns:
-   Host:HOST_1
-   Path prefixes:
  -   PATH_PREFIX_1
  -   PATH_PREFIX_2

-   Host:HOST_2
-   Path prefixes:
  -   PATH_PREFIX_3
  -   PATH_PREFIX_4

// add more hosts and path prefixes as needed

इन्हें बदलें:

  • GCP_PROJECT_NUMBER: Google Cloud प्रोजेक्ट की संख्या जिसके साथ ऐड-ऑन जुड़ा हुआ है.
  • LINK_UPGRADE_IFRAME_URL: वह यूआरएल जो लिंक अपग्रेड iframe.
  • HOST_1: एक होस्ट जिसकी पहचान Classroom को करनी चाहिए. सिर्फ़ https स्कीम काम करती है.
  • PATH_PREFIX_1 और PATH_PREFIX_2: पाथ HOST_1 से जुड़े प्रीफ़िक्स, जिनका पता लगाने के बाद Classroom को कोशिश करनी चाहिए अपग्रेड करने के लिए.
  • HOST_2: एक होस्ट जिसकी पहचान Classroom को करनी चाहिए. सिर्फ़ https स्कीम काम करती है.
  • PATH_PREFIX_3 और PATH_PREFIX_4: पाथ HOST_2 से जुड़े प्रीफ़िक्स, जिनका पता लगाने के बाद Classroom को कोशिश करनी चाहिए अपग्रेड करने के लिए.

इस सुविधा को लागू करते समय, इन सुझावों को ध्यान में रखा जा सकता है.

शिक्षकों के लिए अतिरिक्त काम करने से बचें

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

उपयोगकर्ता के लिए आसान ऐक्सेस से जुड़ी गड़बड़ी के मैसेज शामिल करें

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