इस दस्तावेज़ में, 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 में विषय देखें. |