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

Classroom ऐड-ऑन के लिए Google Cloud प्रोजेक्ट बनाने और उन्हें कॉन्फ़िगर करने के बारे में आपको जिस जानकारी की ज़रूरत होगी वह इस पेज पर मौजूद है. Google Cloud प्रोजेक्ट का इस्तेमाल OAuth 2.0 (Google एसएसओ) की मदद से Google सिंगल साइन-ऑन लागू करने, आपके ऐड-ऑन से किए गए अनुरोधों को अनुमति देने, और Google Workspace Marketplace स्टोर में ऐड-ऑन की लिस्टिंग को मैनेज करने के लिए किया जाता है.

Marketplace पर किसी ऐड-ऑन को पब्लिश करने के बारे में ज़्यादा जानने के लिए, ऐप्लिकेशन पब्लिश करना देखें.

Google Cloud प्रोजेक्ट बनाना

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

Google Cloud प्रोजेक्ट बनाने के बारे में सामान्य जानकारी पाने के लिए, Google Cloud प्रोजेक्ट बनाएं पर जाएं.

Google Cloud का निजी प्रोजेक्ट बनाना

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

निजी प्रोजेक्ट बनाने के लिए, आपके पास Google Workspace for Education के उस डोमेन का ऐक्सेस होना चाहिए जिसके पास Teaching & Learning या Plus का लाइसेंस हो. अगर आपके पास पहले से ऐसे डोमेन का ऐक्सेस नहीं है, तो Google Workspace for Education डेमो डोमेन सेट अप करने के लिए यह तरीका अपनाएं. इसे Plus वर्शन पर अपग्रेड करें लाइसेंस पर अपग्रेड करें, और Classroom ऐड-ऑन एपीआई को ऐक्सेस करने की अनुमति दें:

  1. डेवलपर टेस्ट डोमेन पाने के चरणों को पूरा करें.
  2. डेमो डोमेन में एडमिन के तौर पर साइन इन करके, एक नया Google Cloud प्रोजेक्ट बनाएं.

  3. Classroom API चालू करें.

  4. Google Workspace Marketplace SDK टूल चालू करें.

  5. Marketplace SDK टूल को ऐप्लिकेशन कॉन्फ़िगरेशन ऐप्लिकेशन के दिखने की सेटिंग को निजी पर सेट करें.

  6. डेमो डोमेन अपग्रेड करने के अनुरोध का फ़ॉर्म भरकर सबमिट करें. इस फ़ॉर्म के अनुरोध को सबमिट करने पर, आप Google से अपने डेमो डोमेन को 10 लाइसेंस के साथ Google Workspace for Education Plus पर अपग्रेड करने के लिए कहें. इससे आपका क्लाउड प्रोजेक्ट, Classroom ऐड-ऑन एपीआई में शामिल हो जाता है.

Google Cloud का सार्वजनिक प्रोजेक्ट बनाना

यह प्रोजेक्ट उस ऐड-ऑन ऐप्लिकेशन के बारे में बताता है जिसे एडमिन, शिक्षक और छात्र-छात्राएं ऐक्सेस कर सकते हैं.

  1. नया Google Cloud प्रोजेक्ट बनाएं और Google Workspace Marketplace SDK टूल चालू करें. Marketplace SDK टूल को ऐप्लिकेशन कॉन्फ़िगरेशन ऐप्लिकेशन के दिखने की सेटिंग को सार्वजनिक और सबके लिए मौजूद नहीं पर सेट करें. इंंटरनल टेस्टिंग के दौरान इस्तेमाल किए गए निजी प्रोजेक्ट को, न तो शेयर किया जा सकता है और न ही बदला जा सकता है. यह एक नया प्रोजेक्ट नंबर होना चाहिए.
  2. प्रोजेक्ट को ऐड-ऑन की अनुमति वाली सूची में शामिल करने के लिए, अपने Google पार्टनर के साथ Google Cloud प्रोजेक्ट आईडी शेयर करें. इससे प्रोजेक्ट, Classroom एपीआई की नई ऐड-ऑन सुविधाओं को ऐक्सेस कर पाता है.
  3. ऐड-ऑन को मंज़ूरी मिलने के बाद, Google Workspace Marketplace की टीम, ऐड-ऑन को "सबके लिए मौजूद नहीं" से "सूची में शामिल किया गया है" में बदल देती है. इससे शिक्षक, ऐड-ऑन को स्टोर में देख सकते हैं.

OAuth 2.0

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

सभी उपलब्ध दायरों और उनके इस्तेमाल की ज़्यादा जानकारी के लिए, Google API के लिए OAuth के स्कोप पेज देखें. OAuth कॉन्फ़िगरेशन की सामान्य जानकारी पाने के लिए, Workspace के दस्तावेज़ में OAuth को कॉन्फ़िगर करने का पेज देखें.

उपयोगकर्ता की अनुमतियां

आपके वेब ऐप्लिकेशन को इन स्कोप में से कम से कम एक के लिए अनुरोध करना चाहिए:

  • https://www.googleapis.com/auth/userinfo.email की मदद से, ऐप्लिकेशन को उपयोगकर्ता का ईमेल पता देखने की अनुमति मिलती है.
  • https://www.googleapis.com/auth/userinfo.profile, इसकी मदद से कोई ऐप्लिकेशन, उपयोगकर्ता की ओर से सार्वजनिक तौर पर उपलब्ध कराई गई पोर्ट्रेट, नाम, और उपनाम, और अन्य निजी जानकारी जैसी निजी जानकारी देख सकता है.

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

login_hint और hd स्टैंडर्ड OpenID Connect पैरामीटर हैं. इन्हें 'Google साइन इन' का इस्तेमाल करते समय या OAuth टोकन का अनुरोध करते समय, Google के साथ पास किया जा सकता है. इनका मकसद असली उपयोगकर्ता के लिए, अनुमति देने के अनुभव को बेहतर बनाना है.

Classroom ऐड-ऑन के स्कोप

यहां दिए गए स्कोप, खास तौर पर Classroom ऐड-ऑन के लिए हैं:

  • https://www.googleapis.com/auth/classroom.addons.teacher से, एपीआई के सभी तरीकों को ऐक्सेस किया जा सकता है.
  • https://www.googleapis.com/auth/classroom.addons.student, जो पुष्टि करने और अटैचमेंट रीड ऑपरेशन को लॉन्च करने का ऐक्सेस देता है.

उपयोगकर्ता के क्रेडेंशियल दिखाने वाला मान्य OAuth ऐक्सेस टोकन होने पर भी, एपीआई कॉल पर अतिरिक्त ज़रूरी शर्तें लागू होती हैं:

  • सभी तरीकों के लिए यह ज़रूरी है कि उपयोगकर्ता, courseId में अनुरोध में बताए गए कोर्स का शिक्षक या छात्र/छात्रा हो.
  • अटैचमेंट बनाने, अपडेट करने, मिटाने, और ग्रेड पासबैक के लिए उपयोगकर्ता का शिक्षक होना ज़रूरी है.
  • Google Classroom की किसी खास पोस्ट पर किए जाने वाले कॉल पर, नीचे दिए गए सही का निशान लगाकर लगाई जाती है.
    • अगर किसी ऐड-ऑन में पहले से ही किसी पोस्ट में कम से कम एक अटैचमेंट मौजूद हो, तो वह इन चीज़ों के लिए अनुरोध कर सकता है:
      • iframe लॉन्च करने की पुष्टि
      • अटैचमेंट को पढ़ने, अपडेट करने, और मिटाने की कार्रवाइयां
      • उस पोस्ट पर ग्रेड से जुड़े अपडेट
    • अटैचमेंट डिस्कवरी iframe को पहली बार खोलने पर, हो सकता है कि पोस्ट में ऐड-ऑन मौजूद न हो. एक addOnToken क्वेरी पैरामीटर किया गया है, जिसका इस्तेमाल इनके लिए अनुरोध करने के लिए किया जा सकता है:
      • पोस्ट के तहत अटैचमेंट बनाया जा रहा है (addOnToken ज़रूरी है)
      • लॉन्च की पुष्टि (अगर ऐड-ऑन दिया गया हो, तो addOnToken की पुष्टि की जाती है. अगर पोस्ट में कोई अटैचमेंट पहले से मौजूद न हो, तो यह ज़रूरी है)

OAuth की पुष्टि करना

Classroom ऐड-ऑन, Google उपयोगकर्ताओं का डेटा ऐक्सेस करने के लिए Google API का इस्तेमाल करता है.

पुष्टि की प्रक्रिया के बारे में ज़्यादा जानकारी के लिए, OAuth का इस्तेमाल करके, एपीआई की पुष्टि से जुड़े अक्सर पूछे जाने वाले सवाल देखें.

Google Workspace Marketplace की लिस्टिंग

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

Google Workspace Marketplace के SDK टूल के कॉन्फ़िगरेशन की सामान्य जानकारी के लिए, Google Workspace Marketplace SDK टूल चालू और कॉन्फ़िगर करें पर जाएं. साथ ही, Google Workspace Marketplace पर स्टोर पेज बनाएं.

लिस्टिंग से जुड़ी ज़रूरी बातें

आपके सार्वजनिक Google Cloud प्रोजेक्ट की Marketplace SDK Store Listing, आपके ऐप्लिकेशन के उस नाम और ब्यौरे के बारे में बताती है जो असली उपयोगकर्ताओं के लिए है. ऐप्लिकेशन की जानकारी में जाकर, यह जानकारी कई भाषाओं में दी जा सकती है.

अपनी लिस्टिंग में इन दिशा-निर्देशों का पालन करें:

  • ऐप्लिकेशन की जानकारी में:

    • ऐप्लिकेशन के नाम में विराम चिह्नों का इस्तेमाल न करें. उदाहरण के लिए, "मेरी कंपनी: मेरा ऐड-ऑन" या "मेरी कंपनी का मेरा ऐड-ऑन" के बजाय "मेरी कंपनी का मेरा ऐड-ऑन" का इस्तेमाल करें.

    • छोटा ब्यौरा और ज़्यादा जानकारी में एक जैसा टेक्स्ट नहीं होना चाहिए.

    • पक्का करें कि आपने कीमत फ़ील्ड के लिए वैल्यू चुनी हो. इस फ़ील्ड में मुफ़्त, पैसे चुकाकर बिना किसी शुल्क के आज़माने की सुविधा, पैसे चुकाकर ली जाने वाली मुफ़्त सुविधाओं के साथ, और पैसे चुकाकर ली जाने वाली कीमत के विकल्प शामिल होते हैं. आपको Marketplace की लिस्टिंग में, कीमत तय करने की ज़रूरत नहीं है.

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

    • ज़्यादा जानकारी के लिए, Marketplace की ऐप्लिकेशन के बारे में जानकारी में दिए गए आइटम देखें.

  • ग्राफ़िक ऐसेट में:

  • सहायता लिंक के तहत:

    • पक्का करें कि आपने अपने ऐप्लिकेशन की सेवा की शर्तों का लिंक दिया है.
  • पक्का करें कि आपने Google API ब्रैंडिंग के दिशा-निर्देशों का पालन किया है. इनमें, स्वीकार किए गए नाम और ब्यौरे शामिल हैं.

  • अगर आप अपनी लिस्टिंग में मौजूद किसी भी Google प्रॉडक्ट के बारे में बताते हैं, तो उसके नाम का इस्तेमाल ट्रेडमार्क सूची में दिए गए फ़ॉर्मैट में करें. पक्का करें कि आपने अगर बताया है, तो ट्रेडमार्क (TM) सिंबल शामिल करें. "Google Docs" के बजाय, "Google DocsTM" का इस्तेमाल करें.

Google की लाइसेंसिंग और बिलिंग सेवाओं के साथ इंटिग्रेट करें

अगर आपको Google Workspace Marketplace पर मौजूद ऐप्लिकेशन को, Google की लाइसेंसिंग और बिलिंग सेवाओं के साथ इंटिग्रेट करने की अनुमति देनी है, तो Marketplace API पर जाएं.

इंस्टॉलेशन सेटिंग

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

एडमिन को इंस्टॉल करना

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

व्यवस्थापक इंस्टॉलेशन के संबंध में कुछ मान्यताएं नीचे दी गई हैं.

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

एडमिन इंस्टॉलेशन करने के तरीके और संगठन की इकाइयों और ऐक्सेस ग्रुप के बारे में ज़्यादा जानने के लिए संगठन की संरचना कैसे काम करती है, इस बारे में ज़्यादा जानकारी के लिए अपने डोमेन में Marketplace पर मौजूद ऐप्लिकेशन इंस्टॉल करना देखें.

अलग से इंस्टॉल करना

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

अलग-अलग इंस्टॉल करने के बारे में यहां कुछ बातें बताई गई हैं.

  • ऐप्लिकेशन को आसानी से इस्तेमाल करना. ज़्यादा उपयोगकर्ता, Google Workspace Marketplace से आपका ऐड-ऑन देख सकते हैं और उसे इंस्टॉल कर सकते हैं. अलग-अलग इंस्टॉल करने की अनुमति देने पर, हो सकता है कि ज़्यादा शिक्षकों को आपके प्रॉडक्ट का इस्तेमाल करने या उसे बढ़ावा देने के लिए बढ़ावा मिले.
  • एडमिन टेस्टिंग. एडमिन किसी ऐड-ऑन को किसी बड़े ग्रुप के लिए अनुमति देने या इंस्टॉल करने से पहले, उसकी जांच या आकलन करने के लिए अलग-अलग इंस्टॉल कर सकता है.

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

ज़्यादा जानकारी के लिए, Google Workspace Marketplace पर मौजूद इंस्टॉलेशन सेटिंग का दस्तावेज़ देखें.

ऐप्लिकेशन इंटिग्रेशन

आपको अटैचमेंट सेटअप यूआरआई फ़ील्ड में, लॉन्च iframe यूआरएल देना होगा. इस यूआरएल का इस्तेमाल, अटैचमेंट डिस्कवरी iframe के लिए iframe src वैल्यू के तौर पर किया जाता है. अटैचमेंट डिस्कवरी iframe का इस्तेमाल, शिक्षक अपने असाइनमेंट में अटैच करने के लिए कॉन्टेंट या गतिविधियां ढूंढने के लिए करते हैं.

आपको वे सभी यूआरआई प्रीफ़िक्स भी तय करने होंगे जिनसे अटैचमेंट को भेजने की अनुमति है. यह सुविधा सुरक्षा को बढ़ाती है. ऐसा करने से, बिना अनुमति वाले सोर्स से अटैचमेंट नहीं आते.

इन फ़ील्ड के बारे में ज़्यादा जानकारी के लिए, iframe गाइड पेज देखें.

टेस्ट खाते

अपने निजी ऐड-ऑन के सही व्यवहार की पुष्टि करने के लिए अपने डेमो डोमेन पर टेस्ट खाते बनाएं. छात्र-छात्राओं के काम की समीक्षा करने वाले iframe में, छात्र-छात्राओं के बीच स्विच करने की जांच करने के लिए, दो छात्र-छात्राओं के खातों की ज़रूरत होती है.

सुझाए गए टेस्ट खाते:

  • टैमी शिक्षक, tammy.teacher@<yourडेमो डोमेन>
  • [व्यक्ति का नाम], sam.student@<yourडेमो डोमेन>
  • शालिनी स्टूडेंट, sally.student@<yourडेमो डोमेन>

नया टेस्ट खाता बनाने के लिए, यह तरीका अपनाएं:

  1. अपने Admin console में लॉगिन करें.
  2. उपयोगकर्ता पर जाएं.
  3. नया उपयोगकर्ता जोड़ें पर क्लिक करें (इमेज 1 देखें).
  4. उपयोगकर्ता की जानकारी डालें और सही भूमिकाएं असाइन करें.

&#39;नया उपयोगकर्ता जोड़ें&#39; पर क्लिक करें पहली इमेज. Admin console में नया उपयोगकर्ता जोड़ें लिंक की जगह.

नया टेस्ट ग्रुप बनाने के लिए, यह तरीका अपनाएं:

  1. अपने Admin console में लॉगिन करें.
  2. ग्रुप पर जाएं.
  3. ग्रुप बनाएं पर क्लिक करें (दूसरा डायग्राम देखें).
  4. ग्रुप के सदस्यों और मालिकों के नाम डालें.

&#39;ग्रुप बनाएं&#39; पर क्लिक करें दूसरी इमेज. Admin console में ग्रुप बनाएं लिंक की जगह.