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

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

Classroom एपीआई में, CourseWork एंडपॉइंट से क्या बनाया जा सकता है?

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

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

CourseWork के इस्तेमाल के कुछ सैंपल:

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

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

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

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

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

मेरे आवेदन से असाइनमेंट या सबमिशन में किस तरह के आइटम अटैच किए जा सकते हैं?

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

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

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

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

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

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

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

अभी नहीं. सवाल बनाए जा सकते हैं और उनमें बदलाव किए जा सकते हैं. प्रोग्राम के हिसाब से सवालों के जवाब देना हमारे रोडमैप में है.

Classroom ऐड-ऑन

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

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

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

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

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

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

बंडलिंग के संबंध में दो अतिरिक्त ध्यान देने वाली बातें हैं:

  1. Classroom ऐड-ऑन, सिर्फ़ Teaching & Learning Upgrade या Education Plus SKU के सदस्यों के लिए उपलब्ध हैं.

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

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

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

लोगों का अनुभव

हमारा लोगो किसी छोटे स्क्वेयर में फ़िट नहीं होता. iframe के टाइटल बार में लोगो के लिए, साइज़ के कौनसे विकल्प मौजूद हैं?

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

डोमेन

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

स्कूल के एडमिन यह कंट्रोल कर सकते हैं कि कौनसे शिक्षक इंस्टॉल किए गए ऐड-ऑन को देख सकते हैं.

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

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

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

API

पार्टनर पेज iframe में लोड हुआ है या पॉपआउट टैब में, इसका पता लगाने का सबसे भरोसेमंद तरीका क्या है?

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

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

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

क्या Early access program के दौरान, एपीआई में नुकसान पहुंचा सकने वाले बदलाव हो सकते हैं?

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

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

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

Classroom ऐड-ऑन सार्वजनिक तौर पर कब रिलीज़ किए जाएंगे?

2022 की गर्मियों से सभी असली उपयोगकर्ताओं के लिए, Classroom ऐड-ऑन उपलब्ध हैं. उम्मीद है कि ऐड-ऑन एपीआई, डेवलपर के लिए 2024 में आम तौर पर उपलब्ध हो जाएगा.

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

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

क्या हर छात्र/छात्रा के पास सही ईमेल पता है, भले ही उसके पास Gmail का ऐक्सेस न हो?

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

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

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

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

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

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

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

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

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

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