इस दस्तावेज़ में, Google Calendar API के लिए खास तौर पर अनुमति देने और पुष्टि करने के बारे में जानकारी दी गई है. इस दस्तावेज़ को पढ़ने से पहले, पुष्टि और अनुमति के बारे में जानें पर जाकर, Google Workspace की पुष्टि और अनुमति से जुड़ी सामान्य जानकारी ज़रूर पढ़ें.
अनुमति देने के लिए OAuth 2.0 को कॉन्फ़िगर करना
OAuth को सहमति देने वाली स्क्रीन को कॉन्फ़िगर करें और स्कोप चुनें. इससे यह तय किया जा सकेगा कि उपयोगकर्ताओं और ऐप्लिकेशन की समीक्षा करने वालों को कौनसी जानकारी दिखेगी. साथ ही, अपने ऐप्लिकेशन को रजिस्टर करें, ताकि बाद में उसे पब्लिश किया जा सके.
Calendar API के स्कोप
अपने ऐप्लिकेशन को दिए गए ऐक्सेस का लेवल तय करने के लिए, आपको अनुमति के स्कोप की पहचान करनी होगी और उन्हें ज़ाहिर करना होगा. अनुमति का दायरा, OAuth 2.0 यूआरआई स्ट्रिंग होती है. इसमें Google Workspace ऐप्लिकेशन का नाम, ऐक्सेस किए जाने वाले डेटा का टाइप, और ऐक्सेस का लेवल शामिल होता है. स्कोप, Google Workspace डेटा के साथ काम करने के लिए आपके ऐप्लिकेशन के अनुरोध होते हैं. इनमें उपयोगकर्ताओं के Google खाते का डेटा भी शामिल होता है.
जब आपका ऐप्लिकेशन इंस्टॉल किया जाता है, तो उपयोगकर्ता से ऐप्लिकेशन के इस्तेमाल किए गए स्कोप की पुष्टि करने के लिए कहा जाता है. आम तौर पर, आपको सबसे ज़्यादा फ़ोकस वाला स्कोप चुनना चाहिए. साथ ही, ऐसे स्कोप के लिए अनुरोध करने से बचना चाहिए जिनकी आपके ऐप्लिकेशन को ज़रूरत नहीं है. उपयोगकर्ता, सीमित और साफ़ तौर पर बताए गए स्कोप को आसानी से ऐक्सेस दे देते हैं.
Calendar API इन स्कोप के साथ काम करता है:
| दायरा | मतलब |
|---|---|
https://www.googleapis.com/auth/calendar |
Google Calendar का इस्तेमाल करके, आपके ऐक्सेस के तहत आने वाले सभी कैलेंडर देखे जा सकते हैं, उनमें बदलाव किया जा सकता है, उन्हें शेयर किया जा सकता है, और हमेशा के लिए मिटाया जा सकता है. |
https://www.googleapis.com/auth/calendar.readonly |
जिस कैलेंडर को Calendar का इस्तेमाल करके ऐक्सेस किया जा सकता है उसे देखना और डाउनलोड करना. |
https://www.googleapis.com/auth/calendar.freebusy |
अपने कैलेंडर में अपनी उपलब्धता देखें. |
https://www.googleapis.com/auth/calendar.events |
अपने सभी कैलेंडर पर इवेंट देखें और उनमें बदलाव करें. |
https://www.googleapis.com/auth/calendar.events.readonly |
अपने सभी कैलेंडर पर इवेंट देखें. |
https://www.googleapis.com/auth/calendar.settings.readonly |
अपनी Calendar सेटिंग देखें. |
https://www.googleapis.com/auth/calendar.addons.execute |
इसे Calendar ऐड-ऑन के तौर पर चलाएं. |
https://www.googleapis.com/auth/calendar.addons.current.event.read |
Google Calendar में खोले गए इवेंट देखें. |
https://www.googleapis.com/auth/calendar.addons.current.event.write |
Google Calendar में खोले गए इवेंट में बदलाव करें. |
https://www.googleapis.com/auth/calendar.events.owned |
आपके Google Calendar में इवेंट देखना, बनाना, बदलना, और मिटाना. |
https://www.googleapis.com/auth/calendar.events.owned.readonly |
आपके Google Calendar के इवेंट देखना. |
https://www.googleapis.com/auth/calendar.events.freebusy |
आपके पास जिन Google Calendar का ऐक्सेस है उनमें यह देखना कि विज्ञापन कैंपेन के शेड्यूल उपलब्ध हैं या नहीं. |
https://www.googleapis.com/auth/calendar.app.created |
दूसरे Google Calendar बनाना और उनमें इवेंट देखना, बनाना, बदलना, और मिटाना. |
https://www.googleapis.com/auth/calendar.calendarlist |
आपने जिन Google Calendar की सदस्यता ली है उन्हें देखना, जोड़ना, और हटाना. |
https://www.googleapis.com/auth/calendar.calendarlist.readonly |
आपने जिन Google Calendar की सदस्यता ली है उनकी सूची देखें. |
https://www.googleapis.com/auth/calendar.calendars |
जिन Google Calendar पर आपका ऐक्सेस है उनकी प्रॉपर्टी देखना और बदलना. साथ ही, दूसरे कैलेंडर बनाना. |
https://www.googleapis.com/auth/calendar.calendars.readonly |
आपके पास जिन Google Calendar का ऐक्सेस है उनके शीर्षक, ब्यौरे, डिफ़ॉल्ट समय क्षेत्र, और अन्य प्रॉपर्टी देखना. |
https://www.googleapis.com/auth/calendar.acls |
आपके Google Calendar को शेयर करने की अनुमतियां देखना और उन्हें बदलना. |
https://www.googleapis.com/auth/calendar.acls.readonly |
आपके Google Calendar को शेयर करने की अनुमतियां देखना. |
https://www.googleapis.com/auth/calendar.events.public.readonly |
सार्वजनिक कैलेंडर के इवेंट देखना. |