अक्सर पूछे जाने वाले प्रश्न

Classroom में CourseWork को देखना, बनाना, और उसमें बदलाव करना

Classroom API में CourseWork एंडपॉइंट का इस्तेमाल करके, क्या-क्या बनाया जा सकता है?

इन एंडपॉइंट की मदद से डेवलपर, किसी क्लास में किए गए काम को देख और मैनेज कर सकते हैं. खास तौर पर, ये सभी काम किए जा सकते हैं:

  • किसी उपयोगकर्ता के लिए असाइनमेंट और सवाल (इन दोनों को मिलाकर CourseWork कहा जाता है) देखें.
  • CourseWork बनाना, उसमें बदलाव करना, और उसे मिटाना.
  • CourseWork में संसाधन (Drive फ़ाइलें, YouTube वीडियो, लिंक) अटैच करें.
  • छात्र-छात्रा के सबमिशन की स्थिति बदलना. जैसे, सबमिट करना, वापस करना, और फिर से पाना.
  • किसी असाइनमेंट सबमिशन के लिए ग्रेड सेट करें.
  • छात्र-छात्राओं के सबमिट किए गए असाइनमेंट में, संसाधन (Drive की फ़ाइलें, YouTube वीडियो, लिंक) अटैच करें.

CourseWork के लिए, इस्तेमाल के कुछ उदाहरण:

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

असाइनमेंट बनाने या उनमें बदलाव करने के लिए, मेरे ऐप्लिकेशन को किन अनुमतियों की ज़रूरत होगी?

आम तौर पर, कोई ऐप्लिकेशन सिर्फ़ उस काम में बदलाव कर सकता है जिसे उसने बनाया है. दूसरे शब्दों में कहें, तो CourseWork में बदलाव करने के लिए किए गए किसी भी एपीआई अनुरोध में, उसी Google Cloud प्रोजेक्ट आईडी का इस्तेमाल किया जाना चाहिए जिसका इस्तेमाल CourseWork बनाने के लिए किया गया था.

Google Classroom के ऐड-ऑन के लिए, इस नियम में एक अपवाद है. कोई Cloud प्रोजेक्ट, ऐसे किसी भी एलान, असाइनमेंट या मटीरियल को ऐक्सेस कर सकता है या उसमें बदलाव कर सकता है जिसमें उसके एक या उससे ज़्यादा ऐड-ऑन अटैचमेंट हों. क्लाउड प्रोजेक्ट, ऐसे असाइनमेंट को भी सबमिट कर सकता है, वापस पा सकता है या वापस भेज सकता है जिसमें एक या उससे ज़्यादा ऐड-ऑन अटैचमेंट हों.

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

मेरा ऐप्लिकेशन, असाइनमेंट या सबमिशन में किस तरह के आइटम अटैच कर सकता है?

इस एपीआई की मदद से, Drive में मौजूद फ़ाइलें, YouTube वीडियो, और लिंक अटैच किए जा सकते हैं. फ़िलहाल, Google फ़ॉर्म अटैच करने की सुविधा उपलब्ध नहीं है.

क्या Classroom के उपयोगकर्ताओं को पता है कि मेरे ऐप्लिकेशन ने कोई असाइनमेंट बनाया है?

हां. Classroom का यूज़र इंटरफ़ेस (यूआई), बाहरी तौर पर बनाए गए असाइनमेंट की पहचान करता है. इसके लिए, वह Google Cloud प्रोजेक्ट के उस प्रॉडक्ट के नाम का इस्तेमाल करता है जिसने काम बनाया है. उपयोगकर्ता, बाहरी ऐप्लिकेशन से बनाए गए कॉन्टेंट को अवांछित के तौर पर रिपोर्ट कर सकते हैं. साथ ही, उस ऐप्लिकेशन को डिस्कनेक्ट कर सकते हैं जिसने कॉन्टेंट बनाया है. इसके लिए, उपयोगकर्ता को ऐप्लिकेशन को दिए गए क्रेडेंशियल रद्द करने होंगे.

Classroom में शेयर करने का बटन और अन्य इंटिग्रेशन

मैंने Classroom के 'शेयर करें' बटन के साथ पहले ही इंटिग्रेट कर लिया है. क्या शेयर बटन का इस्तेमाल करके बनाए गए असाइनमेंट में बदलाव किया जा सकता है?

अब तक नहीं। किसी असाइनमेंट में बदलाव करने के लिए, अनुरोध में उसी Google Cloud प्रोजेक्ट का इस्तेमाल किया जाना चाहिए जिसने असाइनमेंट बनाया है.

क्या एपीआई में सवालों के जवाब दिए जा सकते हैं?

अब तक नहीं। आपके पास सवाल बनाने और उनमें बदलाव करने का विकल्प होता है.

Classroom ऐड-ऑन

प्रोजेक्ट कॉन्फ़िगरेशन

क्या डेवलपमेंट के दौरान इस्तेमाल किए गए किसी निजी Google Cloud प्रोजेक्ट को ऐसे सार्वजनिक प्रोजेक्ट में बदला जा सकता है जिसका इस्तेमाल प्रोडक्शन में किया जा सके?

नहीं, किसी निजी Google Cloud प्रोजेक्ट को सार्वजनिक प्रोजेक्ट में नहीं बदला जा सकता. आपको दो अलग-अलग प्रोजेक्ट की ज़रूरत होगी. एक डेवलपमेंट के लिए और दूसरा प्रोडक्शन के लिए.

क्या एक Google Cloud प्रोजेक्ट के लिए, Google Workspace Marketplace में दो लिस्टिंग हो सकती हैं?

नहीं. एक Google Cloud प्रोजेक्ट के लिए, Google Workspace Marketplace की दो लिस्टिंग नहीं बनाई जा सकतीं.

हालांकि, ऐड-ऑन को बंडल किया जा सकता है. ऐसा करने से, Google Workspace Marketplace की एक लिस्टिंग में कई ऐड-ऑन दिखाए जा सकते हैं. इस तरह की लिस्टिंग से इंस्टॉल करने पर, बंडल में मौजूद सभी ऐड-ऑन एक साथ इंस्टॉल हो जाएंगे. अनुमति देते समय, उपयोगकर्ताओं को बंडल किए गए ऐड-ऑन के लिए ज़रूरी सभी स्कोप के लिए सहमति देनी होगी.

क्या किसी दूसरे Google Cloud प्रोजेक्ट के OAuth क्लाइंट को, Classroom ऐड-ऑन के लिए Google Cloud प्रोजेक्ट के साथ फिर से इस्तेमाल किया जा सकता है?

नहीं, Classroom ऐड-ऑन के Google Cloud प्रोजेक्ट के अलावा, किसी दूसरे Google Cloud प्रोजेक्ट का OAuth क्लाइंट काम नहीं कर सकता. Classroom API, किसी दूसरे Google Cloud प्रोजेक्ट से जनरेट किए गए ऐक्सेस टोकन को स्वीकार नहीं करता. आपको ऐड-ऑन प्रोजेक्ट के लिए, एक अलग OAuth क्लाइंट बनाना होगा.

उपयोगकर्ता अनुभव

हमारा लोगो, छोटे स्क्वेयर में ठीक से नहीं दिखता. Classroom ऐड-ऑन के iframe टाइटल बार में लोगो के लिए साइज़ के कौनसे विकल्प उपलब्ध हैं?

iframe टाइटल बार को सिर्फ़ 32x32 स्क्वेयर लोगो के साथ काम करने के लिए डिज़ाइन किया गया था. यह फ़ैसला इसलिए लिया गया है, ताकि फ़ेविकॉन का आकार उन फ़ेविकॉन से मेल खाए जिनका इस्तेमाल कंपनियां अपनी वेबसाइटों पर करती हैं. साथ ही, ब्रैंड की पहचान को एक जैसा बनाए रखने के लिए, हमारा सुझाव है कि आप इस स्पेस में भी उसी लोगो का इस्तेमाल करें.

डोमेन

क्या एक ही डोमेन के सभी शिक्षकों और छात्र-छात्राओं के पास, इंस्टॉल किए गए ऐड-ऑन का ऐक्सेस होता है?

डोमेन एडमिन के पास यह कंट्रोल करने का विकल्प होता है कि कौनसे शिक्षक, इंस्टॉल किया गया ऐड-ऑन देख सकते हैं. Classroom ऐड-ऑन का इस्तेमाल सिर्फ़ वे उपयोगकर्ता कर सकते हैं जिनके पास Teaching & Learning या Education Plus का लाइसेंस है.

डोमेन एडमिन, ऐड-ऑन के साथ कैसे इंटरैक्ट करते हैं?

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

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

एपीआई

यह जानने का भरोसेमंद तरीका क्या है कि ऐड-ऑन का कॉन्टेंट, iframe या नए टैब में लोड हुआ है या नहीं?

फ़िलहाल, इन दोनों के बीच अंतर करने का कोई तरीका नहीं है.

असाइन किए जा सकने वाले किन कामों के लिए, छात्र-छात्राओं के काम की समीक्षा करने वाला iframe मिलता है?

छात्र-छात्राओं के काम की समीक्षा करने वाला iframe, सिर्फ़ गतिविधि वाले अटैचमेंट के लिए उपलब्ध कराया जाता है. courses.courseWork.getAddOnContext तरीके को कॉल करें, ताकि यह पता चल सके कि पोस्ट टाइप, छात्र-छात्रा के काम को सपोर्ट करता है या नहीं. supportsStudentWork फ़ील्ड को सिर्फ़ true के तौर पर सेट किया जा सकता है. हालांकि, ऐसा सिर्फ़ गतिविधि वाली पोस्ट के लिए किया जा सकता है.

क्या ऐड-ऑन अटैचमेंट, उस स्ट्रीम आइटम को ऐक्सेस कर सकता है जिससे वह अटैच है?

हां. आपके पास किसी भी Announcement, CourseWork या CourseWorkMaterial को get या patch करने का विकल्प होता है. इनमें से किसी एक में, कम से कम एक ऐड-ऑन अटैचमेंट होना चाहिए. आपके पास CourseWork StudentSubmission को reclaim, return या turnIn करने का विकल्प होता है.

सिंगल साइन-ऑन

हां, वे अब भी Google से साइन इन करने की सुविधा का इस्तेमाल कर सकते हैं.

क्या हर छात्र-छात्रा के पास सही फ़ॉर्मैट वाला ईमेल पता है, भले ही उनके पास Gmail का ऐक्सेस न हो?

Google Workspace for Education इस्तेमाल करने वाले हर व्यक्ति के पास Google आइडेंटिटी होती है. इससे कोई फ़र्क़ नहीं पड़ता कि उसके पास Gmail का ऐक्सेस है या नहीं. किसी भी Google सेवा (Gmail सहित) के लिए, पहचान और ऐक्सेस अलग-अलग होते हैं. Gmail बंद होने पर भी, छात्र-छात्राएं अपने ईमेल पते से Classroom में साइन इन कर सकते हैं. पहचानों को यूज़र आईडी और ईमेल पते से दिखाया जाता है. Google Workspace for Education का इस्तेमाल करने वाला व्यक्ति अपना ईमेल पता बदल सकता है. इसलिए, हमारा सुझाव है कि उपयोगकर्ता की जानकारी सेव करते समय, उपयोगकर्ता आईडी को प्राइमरी कुंजियों के तौर पर इस्तेमाल करें.

क्या छात्र-छात्राओं को साइन इन करने की अनुमति देने के लिए, स्कूल के एडमिन को ऐप्लिकेशन को पहले से मंज़ूरी देनी होगी?

किसी ऐड-ऑन को इंस्टॉल करने से पहले, डोमेन एडमिन को उसे अनुमति वाली सूची में शामिल करना होगा. इसके अलावा, डोमेन एडमिन के पास यह विकल्प होता है कि वे डोमेन या संगठन की किसी इकाई में मौजूद सभी उपयोगकर्ताओं के लिए, ऐड-ऑन इंस्टॉल करें.

सुझाव/राय देना या शिकायत करना और सामान्य सवाल पूछना

मैं सुविधाओं के लिए अनुरोध या समस्याओं की शिकायत कैसे सबमिट करूं?

हमारे सार्वजनिक समस्या ट्रैकर में जाकर, सुविधा के अनुरोध सबमिट किए जा सकते हैं. साथ ही, उन्हें देखा जा सकता है और उन पर वोट किया जा सकता है.

मुझे कैसे पता चलेगा कि Classroom API में नई सुविधाएं उपलब्ध हैं?

एपीआई से जुड़े अपडेट, डेवलपर न्यूज़लेटर और सार्वजनिक समस्या ट्रैकर पर पोस्ट किए जाते हैं.

मैं Classroom API का इस्तेमाल कर रहा/रही हूं. मैं तकनीकी सवाल कैसे पूछूं?

अपने सवालों को Stack Overflow पर google-classroom टैग के साथ पोस्ट करें.