इस दस्तावेज़ में, Google Classroom API के लिए खास तौर पर अनुमति देने और पुष्टि करने के बारे में जानकारी दी गई है. इस दस्तावेज़ को पढ़ने से पहले, पुष्टि और अनुमति के बारे में जानें पर जाकर, Google Workspace की पुष्टि और अनुमति से जुड़ी सामान्य जानकारी ज़रूर पढ़ें.
अनुमति देने के लिए OAuth 2.0 को कॉन्फ़िगर करना
OAuth को सहमति देने वाली स्क्रीन को कॉन्फ़िगर करें और स्कोप चुनें. इससे यह तय किया जा सकेगा कि उपयोगकर्ताओं और ऐप्लिकेशन की समीक्षा करने वालों को कौनसी जानकारी दिखेगी. साथ ही, अपने ऐप्लिकेशन को रजिस्टर करें, ताकि बाद में उसे पब्लिश किया जा सके.
Classroom API के स्कोप
अपने ऐप्लिकेशन को दिए गए ऐक्सेस के लेवल के बारे में बताने के लिए, आपको अनुमति के स्कोप की पहचान करनी होगी और उन्हें ज़ाहिर करना होगा. ऑथराइज़ेशन स्कोप, OAuth 2.0 यूआरआई स्ट्रिंग होती है. इसमें Google Workspace ऐप्लिकेशन का नाम, ऐक्सेस किए जाने वाले डेटा का टाइप, और ऐक्सेस का लेवल शामिल होता है. स्कोप, Google Workspace डेटा के साथ काम करने के लिए आपके ऐप्लिकेशन के अनुरोध होते हैं. इनमें उपयोगकर्ताओं के Google खाते का डेटा भी शामिल होता है.
जब आपका ऐप्लिकेशन इंस्टॉल किया जाता है, तो उपयोगकर्ता से ऐप्लिकेशन के इस्तेमाल किए गए स्कोप की पुष्टि करने के लिए कहा जाता है. आम तौर पर, आपको सबसे ज़्यादा फ़ोकस वाला स्कोप चुनना चाहिए. साथ ही, ऐसे स्कोप के लिए अनुरोध करने से बचना चाहिए जिनकी आपके ऐप्लिकेशन को ज़रूरत नहीं है. उपयोगकर्ता, सीमित और साफ़ तौर पर बताए गए स्कोप को आसानी से ऐक्सेस दे देते हैं.
Classroom API, इन स्कोप के साथ काम करता है:
| स्कोप | मतलब |
|---|---|
https://www.googleapis.com/auth/classroom.addons.teacher
|
Google Classroom में जिन विषयों को पढ़ाया जाता है उनसे जुड़े स्ट्रीम आइटम के लिए, अनुरोध करने वाले Google Cloud प्रोजेक्ट के अटैचमेंट देखना, बनाना, और अपडेट करना. |
https://www.googleapis.com/auth/classroom.addons.student
|
Google Classroom में स्ट्रीम किए गए आइटम के लिए, अनुरोध करने वाले Google Cloud प्रोजेक्ट के अटैचमेंट देखना और उन्हें अपडेट करना. |
https://www.googleapis.com/auth/classroom.announcements
|
Google Classroom में सूचनाएं देखें और उन्हें मैनेज करें. |
https://www.googleapis.com/auth/classroom.announcements.readonly
|
Google Classroom में सूचनाएं देखें. |
https://www.googleapis.com/auth/classroom.courses
|
Google Classroom की अपनी क्लास देखना, उनमें बदलाव करना, उन्हें बनाना, और हमेशा के लिए मिटाना. |
https://www.googleapis.com/auth/classroom.courses.readonly
|
अपनी Google Classroom क्लास देखें. |
https://www.googleapis.com/auth/classroom.coursework.me
|
कोर्सवर्क के उन आइटम को देखना, बनाना, और उनमें बदलाव करना जिनमें असाइनमेंट, सवाल, और ग्रेड शामिल हैं. |
https://www.googleapis.com/auth/classroom.coursework.me.readonly
|
Google Classroom में अपना कोर्स वर्क और ग्रेड देखें. |
https://www.googleapis.com/auth/classroom.coursework.students
|
Google Classroom की उन क्लास के छात्रों के लिए कोर्स वर्क और ग्रेड मैनेज करें जिनमें आप पढ़ाते हैं. साथ ही, उन क्लास के लिए कोर्स वर्क और ग्रेड देखें जिन्हें आपने मैनेज किया है. |
https://www.googleapis.com/auth/classroom.coursework.students.readonly
|
Google Classroom की उन क्लास के छात्रों का कोर्सवर्क और ग्रेड देखें जिन्हें आपने बनाया है या जिनमें आपको शिक्षक की भूमिका मिली है. |
https://www.googleapis.com/auth/classroom.courseworkmaterials
|
Google Classroom में क्लासवर्क की सामग्रियां देखें, उनमें बदलाव करें, और बनाएं. |
https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly
|
Google Classroom में अपनी क्लास के सभी क्लासवर्क की सामग्री देखें. |
https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly
|
Google Classroom में अपने अभिभावकों की जानकारी देखें. |
https://www.googleapis.com/auth/classroom.guardianlinks.students
|
अपनी Google Classroom क्लास में शामिल छात्रों के अभिभावकों को देखें और उन्हें मैनेज करें. |
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly
|
अपनी Google Classroom क्लास में शामिल छात्र-छात्राओं के अभिभावकों की जानकारी देखें. |
https://www.googleapis.com/auth/classroom.profile.emails
|
अपनी क्लास में मौजूद लोगों के ईमेल पते देखना. |
https://www.googleapis.com/auth/classroom.profile.photos
|
अपनी क्लास में मौजूद लोगों की प्रोफ़ाइल फ़ोटो देखना. |
https://www.googleapis.com/auth/classroom.push-notifications
|
अपने Google Classroom डेटा के बारे में सूचनाएं पाएं. |
https://www.googleapis.com/auth/classroom.rosters
|
Google Classroom में अपनी क्लास की रोस्टर मैनेज करें. |
https://www.googleapis.com/auth/classroom.rosters.readonly
|
Google Classroom में अपनी क्लास की रोस्टर देखना. |
https://www.googleapis.com/auth/classroom.student-submissions.me.readonly
|
Google Classroom में अपना कोर्स वर्क और ग्रेड देखें. |
https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
|
Google Classroom की उन क्लास के छात्रों का कोर्सवर्क और ग्रेड देखें जिन्हें आपने बनाया है या जिनमें आपको शिक्षक की भूमिका मिली है. |
https://www.googleapis.com/auth/classroom.topics
|
Google Classroom में विषयों को देखें, बनाएं, और उनमें बदलाव करें. |
https://www.googleapis.com/auth/classroom.topics.readonly
|
Google Classroom में विषय देखें. |