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

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

Classroom API में मौजूद कोर्सवर्क एंडपॉइंट का इस्तेमाल करके, मैं क्या-क्या बना सकता/सकती हूं?

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

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

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

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

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

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

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

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

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

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

क्या एंड यूज़र को पता चलता है कि 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 की एक लिस्टिंग में कई ऐड-ऑन दिखाए जा सकते हैं. ऐसी लिस्टिंग से इंस्टॉल करने पर, बंडल में मौजूद सभी ऐड-ऑन एक साथ इंस्टॉल हो जाएंगे. अनुमति देते समय, उपयोगकर्ताओं को बंडल किए गए ऐड-ऑन के लिए ज़रूरी सभी स्कोप के लिए सहमति देनी होगी.

क्या Classroom ऐड-ऑन के लिए, किसी Google Cloud प्रोजेक्ट के OAuth क्लाइंट को किसी दूसरे 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 का ऐक्सेस हो या न हो. पहचान और Gmail सहित किसी भी Google सेवा का ऐक्सेस, दोनों अलग-अलग होते हैं. Gmail बंद होने पर भी, छात्र-छात्राएं अपने ईमेल पते से Classroom में साइन इन कर सकते हैं. पहचानों को उपयोगकर्ता आईडी और ईमेल पते से दिखाया जाता है. Google Workspace for Education का कोई उपयोगकर्ता अपना ईमेल पता बदल सकता है. इसलिए, हमारा सुझाव है कि उपयोगकर्ता की जानकारी सेव करते समय, उपयोगकर्ता आईडी को प्राइमरी की के तौर पर इस्तेमाल करें.

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

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

सुझाव, शिकायत, राय, और सामान्य सवाल

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

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

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

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

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

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