इस दस्तावेज़ में, Google Workspace Events API से जुड़ी खास अनुमति और पुष्टि करने की जानकारी. इस दस्तावेज़ को पढ़ने से पहले, पक्का करें कि पुष्टि करने और अनुमति देने की सामान्य जानकारी पुष्टि करने और अनुमति देने के बारे में जानें.
अनुमति देने के लिए, OAuth 2.0 को कॉन्फ़िगर करें
उस स्क्रीन को कॉन्फ़िगर करना जहां OAuth के लिए सहमति दी जाती है और स्कोप चुनें ताकि यह तय किया जा सके कि उपयोगकर्ताओं और ऐप्लिकेशन की समीक्षा करने वाले लोगों को कौनसी जानकारी दिखाई जाए. ताकि आप इसे बाद में प्रकाशित कर सकें.
Google Workspace Events API के दायरे
आपके ऐप्लिकेशन को दिए गए ऐक्सेस का लेवल तय करने के लिए, आपको अनुमति के दायरे के बारे में बताएं. अनुमति का स्कोप, OAuth 2.0 यूआरआई स्ट्रिंग है जिसमें Google Workspace ऐप्लिकेशन का नाम, यह किस तरह का डेटा ऐक्सेस करता है, और ऐक्सेस का लेवल तय कर सकते हैं. ये दायरे, आपके ऐप्लिकेशन के Google Workspace डेटा के साथ काम करने के अनुरोधों का दायरा तय करते हैं. इनमें ये दायरे शामिल हैं उपयोगकर्ताओं का Google खाते में मौजूद डेटा.
आपका ऐप्लिकेशन इंस्टॉल होने पर, उपयोगकर्ता से उन दायरों की पुष्टि करने के लिए कहा जाता है ऐप से. आम तौर पर, आपको सबसे सटीक और सटीक स्कोप चुनना चाहिए और ऐसे दायरों का अनुरोध करने से बचें जिनकी ज़रूरत आपके ऐप्लिकेशन में नहीं है. ज़्यादा उपयोगकर्ता सीमित और साफ़ तौर पर बताए गए दायरों का ऐक्सेस आसानी से देना.
हमारा सुझाव है कि जहां भी हो सके, गैर-संवेदनशील स्कोप का इस्तेमाल करें, क्योंकि यह हर फ़ाइल के लिए अनुमति देता है और किसी ऐप्लिकेशन के लिए ज़रूरी खास फ़ंक्शन के ऐक्सेस को सीमित करता है.
Google Workspace Events API, Google Workspace के दायरे का इस्तेमाल करता है ऐसे ऐप्लिकेशन जिनमें सदस्यताओं की सुविधा उपलब्ध है. अगर आपका ऐप्लिकेशन पहले से ही स्कोप का इस्तेमाल कर रहा है जो आपकी सदस्यता के लिए ज़रूरी हैं. इसके लिए आपको के दायरे होते हैं.
नीचे दी गई टेबल में, Google Workspace इवेंट एपीआई:
दायरा कोड | ब्यौरा | इस्तेमाल | ||
---|---|---|---|---|
Google Chat | ||||
https://www.googleapis.com/auth/chat.bot |
Google Chat ऐप्लिकेशन को चैट देखने और मैसेज भेजने की अनुमति दें. गिव Chat ऐप्लिकेशन की सभी सुविधाओं का ऐक्सेस. | संवेदनशील नहीं है | ||
https://www.googleapis.com/auth/chat.memberships |
Google Chat में होने वाली बातचीत में सदस्यों को देखना, जोड़ना, और हटाना. | संवेदनशील |
||
https://www.googleapis.com/auth/chat.memberships.readonly |
Google Chat में होने वाली बातचीत में शामिल सदस्यों को देखें. | संवेदनशील |
||
https://www.googleapis.com/auth/chat.spaces |
Google Chat में बातचीत और स्पेसेज़ बनाएं. साथ ही, मेटाडेटा (इसमें इतिहास की सेटिंग शामिल है) देखें या अपडेट करें. | संवेदनशील | ||
https://www.googleapis.com/auth/chat.spaces.readonly |
Google Chat में मौजूद चैट और स्पेस देखें. | संवेदनशील |
||
https://www.googleapis.com/auth/chat.messages.reaction सेकंड |
Chat में मैसेज में प्रतिक्रियाएं जोड़ना, देखना, और मिटाना. | संवेदनशील |
||
https://www.googleapis.com/auth/chat.messages.reactions.readonly |
Chat में किसी मैसेज पर मिली प्रतिक्रियाएं देखना. | संवेदनशील |
||
https://www.googleapis.com/auth/chat.messages |
मैसेज देखें, लिखें, भेजें, अपडेट करें, और मिटाएं. साथ ही, मैसेज में प्रतिक्रियाएं जोड़ें, देखें, और मिटाएं. | सभी देशों/इलाकों में उपलब्ध नहीं है | ||
https://www.googleapis.com/auth/chat.messages.readonly |
Google Chat में मैसेज और प्रतिक्रियाएं देखें. | प्रतिबंधित |
||
Google Meet | ||||
https://www.googleapis.com/auth/meetings.space.created |
ऐप्लिकेशन को मीटिंग स्पेस के बारे में मेटाडेटा बनाने, उनमें बदलाव करने, और उन्हें पढ़ने की अनुमति दें आपके ऐप्लिकेशन से बनाया गया. | संवेदनशील |
||
https://www.googleapis.com/auth/meetings.space.readonly |
ऐप्लिकेशन को मीटिंग की जिस जगह का ऐक्सेस है उससे जुड़ा मेटाडेटा पढ़ने की अनुमति दें. | संवेदनशील |
पिछली टेबल का इस्तेमाल कॉलम, हर स्कोप की संवेदनशीलता दिखाता है, नीचे दी गई परिभाषाओं के मुताबिक:
गैर-संवेदनशील—ये दायरे अनुमति देने का ऐक्सेस मिलता है. साथ ही, ऐप्लिकेशन की सिर्फ़ बुनियादी पुष्टि करने की ज़रूरत होती है. इसके लिए इस ज़रूरी शर्त की जानकारी तैयार होने के लिए, पुष्टि की प्रक्रिया के लिए.
संवेदनशील—ये दायरे, Google उपयोगकर्ता के खास डेटा का ऐक्सेस देते हैं जिसे उपयोगकर्ता ने आपके ऐप्लिकेशन के लिए अनुमति दी हो. इसके लिए आपको इसे पूरा करना होगा अन्य ऐप्लिकेशन की पुष्टि. इस ज़रूरी शर्त की जानकारी के लिए, चरण संवेदनशील जानकारी का अनुरोध करने वाले ऐप्लिकेशन के लिए स्कोप
प्रतिबंधित—ये दायरे, Google उपयोगकर्ता डेटा का ज़्यादा ऐक्सेस देते हैं के लिए आपको एक प्रतिबंधित दायरे की पुष्टि करने की ज़रूरत होगी. इसके लिए इस ज़रूरी शर्त के बारे में जानकारी पाने के लिए, Google API Services: उपयोगकर्ता का डेटा' देखें नीति और खास एपीआई के लिए अन्य ज़रूरी शर्तें स्कोप. अगर सर्वर पर, प्रतिबंधित स्कोप का डेटा सेव किया जाता है (या ट्रांसमिट किया जाता है), तो आपको सुरक्षा जांच की ज़रूरत है.
अगर आपके ऐप्लिकेशन को किसी अन्य Google API का ऐक्सेस चाहिए, तो उन दायरों को जोड़ा जा सकता है भी. Google API के दायरों के बारे में ज़्यादा जानकारी पाने के लिए, OAuth 2.0 का इस्तेमाल करके Google API ऐक्सेस करना.
खास OAuth 2.0 स्कोप के बारे में ज़्यादा जानकारी पाने के लिए, OAuth 2.0 के स्कोप देखें Google API.
OAuth से पुष्टि
कुछ OAuth दायरों का इस्तेमाल करने के लिए, आपके ऐप्लिकेशन को Google की OAuth से पुष्टि प्रोसेस. OAuth का इस्तेमाल करके, एपीआई की पुष्टि करने के बारे में जानें अक्सर पूछे जाने वाले सवाल यह तय करने के लिए कि आपके ऐप्लिकेशन की पुष्टि कब की जानी चाहिए और किस तरह की की पुष्टि करना ज़रूरी है. Google Drive की अतिरिक्त शर्तें भी देखें सेवा.
पुष्टि करने के ज़रूरी तरीके
इस सेक्शन में बताया गया है कि पुष्टि करने के किस तरीके की ज़रूरत है या किस तरह की पुष्टि की जा सकती है, साथ ही, यहां बताई गई हर प्रोसेस के लिए इस्तेमाल किए जा सकने वाले दायरे Google Workspace इवेंट एपीआई.
Google Chat इवेंट की सदस्यताओं के लिए, Google Workspace Events API
उपयोगकर्ता और ऐप्लिकेशन की पुष्टि करने के कुछ तरीकों का इस्तेमाल करने के लिए, पुष्टि करने की सुविधा देता है. अगर कोई एपीआई
तरीका, दोनों क्रेडेंशियल के साथ काम करता है. यह कॉल में इस्तेमाल किए जाने वाले क्रेडेंशियल का टाइप होता है
मिलने वाले नतीजे पर असर डालता है. उदाहरण के लिए, यदि आप
subscriptions.list()
तरीका है, तो एपीआई उन सदस्यताओं की सूची दिखाता है जिनमें
पुष्टि करने वाला उपयोगकर्ता ऐक्सेस कर सकता है. अगर आप ऐप्लिकेशन की पुष्टि करने की सुविधा का इस्तेमाल करते हैं, तो एपीआई
उन सदस्यताओं की सूची दिखाता है जिन्हें ऐप्लिकेशन ऐक्सेस कर सकता है. इस बारे में ज़्यादा जानने के लिए
चैट की पुष्टि करने का तरीका जानने के लिए, पुष्टि करें और अनुमति दें
Chat ऐप्लिकेशन और Google Chat API
अनुरोध हैं.
इस टेबल में बताया गया है कि हर Google Workspace Events API के लिए पुष्टि करना ज़रूरी है या काम करता है तरीका:
तरीका | उपयोगकर्ता की पुष्टि ज़रूरी है या उपलब्ध है | ऐप्लिकेशन की पुष्टि करने की सुविधा (सिर्फ़ Google Chat ऐप्लिकेशन के लिए) | अनुमति देने के दायरे इस्तेमाल किए जा सकते हैं | |
---|---|---|---|---|
सदस्यता बनाना | — |
हर इवेंट टाइप के लिए, इस्तेमाल किया जा सकने वाला स्कोप होना ज़रूरी है:
|
||
सदस्यता लेना |
उपयोगकर्ता की पुष्टि करने के साथ, इस तरीके के लिए एक ऐसे स्कोप की ज़रूरत होती है जो सदस्यता के लिए कम से कम एक इवेंट टाइप के साथ काम करता हो.
ऐप्लिकेशन की पुष्टि करने की सुविधा के साथ (सिर्फ़ Google Chat के ऐप्लिकेशन के लिए):
|
|||
सदस्यताओं की सूची बनाना |
उपयोगकर्ता की पुष्टि करने के साथ, इस तरीके के लिए एक ऐसे स्कोप की ज़रूरत होती है जो सदस्यता के लिए कम से कम एक इवेंट टाइप के साथ काम करता हो.
ऐप्लिकेशन की पुष्टि करने की सुविधा के साथ (सिर्फ़ Google Chat के ऐप्लिकेशन के लिए):
|
|||
सदस्यता अपडेट करना | — |
हर इवेंट टाइप के लिए, इस्तेमाल किया जा सकने वाला स्कोप होना ज़रूरी है:
|
||
सदस्यता को फिर से चालू करना | — |
हर इवेंट टाइप के लिए, इस्तेमाल किया जा सकने वाला स्कोप होना ज़रूरी है:
|
||
सदस्यता मिटाना |
उपयोगकर्ता की पुष्टि करने के साथ, इस तरीके के लिए एक ऐसे स्कोप की ज़रूरत होती है जो सदस्यता के लिए कम से कम एक इवेंट टाइप के साथ काम करता हो.
ऐप्लिकेशन की पुष्टि करने की सुविधा के साथ (सिर्फ़ Google Chat के ऐप्लिकेशन के लिए):
|
इवेंट टाइप के हिसाब से स्कोप
जब उपयोगकर्ता की पुष्टि करने की सुविधा का इस्तेमाल करके Google Workspace Events API को कॉल किया जाता है, तो एक या एक से ज़्यादा स्कोप तय किए जाने चाहिए जो की सदस्यता लें.
इस टेबल में बताया गया है कि अनुमति पाने के कौनसे दायरे इस्तेमाल किए जा सकते हैं इवेंट टाइप:
इवेंट | इवेंट के टाइप | अनुमति के दायरे इस्तेमाल किए जा सकते हैं | ||||||
---|---|---|---|---|---|---|---|---|
Google Chat | ||||||||
मैसेज पोस्ट या अपडेट किया गया है. |
|
|
||||||
किसी प्रतिक्रिया को जोड़ा या मिटाया जाता है या एक से ज़्यादा प्रतिक्रियाएं बदली जाती हैं. |
|
|
||||||
पैसे चुकाकर ली जाने वाली सदस्यता कई सदस्यताओं को बनाया, अपडेट किया या हटाया गया हो या बदल दिए गए हैं. |
|
|
||||||
स्पेस को अपडेट किया जाता है या मिटाया जाता है. |
|
|
||||||
Google Meet | ||||||||
कोई कॉन्फ़्रेंस शुरू या खत्म होती है. |
|
|
||||||
मीटिंग में हिस्सा लेने वाला कोई व्यक्ति किसी कॉन्फ़्रेंस में शामिल होता है या उसे छोड़ता है. |
|
|
||||||
रिकॉर्डिंग जनरेट की गई. |
|
|
||||||
एक ट्रांसक्रिप्ट जनरेट की गई. |
|
|