Google Workspace Events API के दायरे चुनें

इस दस्तावेज़ में, 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 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 ऐप्लिकेशन के लिए) अनुमति देने के दायरे इस्तेमाल किए जा सकते हैं
सदस्यता बनाना —

हर इवेंट टाइप के लिए, इस्तेमाल किया जा सकने वाला स्कोप होना ज़रूरी है:

  • chat.messages
  • chat.messages.readonly
  • chat.messages.reactions
  • chat.messages.reactions.readonly
  • chat.memberships
  • chat.memberships.readonly
  • chat.spaces
  • chat.spaces.readonly
  • meetings.space.created
  • meetings.space.readonly
सदस्यता लेना उपयोगकर्ता की पुष्टि करने के साथ, इस तरीके के लिए एक ऐसे स्कोप की ज़रूरत होती है जो सदस्यता के लिए कम से कम एक इवेंट टाइप के साथ काम करता हो.

ऐप्लिकेशन की पुष्टि करने की सुविधा के साथ (सिर्फ़ Google Chat के ऐप्लिकेशन के लिए):

  • chat.bot
सदस्यताओं की सूची बनाना उपयोगकर्ता की पुष्टि करने के साथ, इस तरीके के लिए एक ऐसे स्कोप की ज़रूरत होती है जो सदस्यता के लिए कम से कम एक इवेंट टाइप के साथ काम करता हो.

ऐप्लिकेशन की पुष्टि करने की सुविधा के साथ (सिर्फ़ Google Chat के ऐप्लिकेशन के लिए):

  • chat.bot
सदस्यता अपडेट करना —

हर इवेंट टाइप के लिए, इस्तेमाल किया जा सकने वाला स्कोप होना ज़रूरी है:

  • chat.messages
  • chat.messages.readonly
  • chat.messages.reactions
  • chat.messages.reactions.readonly
  • chat.memberships
  • chat.memberships.readonly
  • chat.spaces
  • chat.spaces.readonly
  • meetings.space.created
  • meetings.space.readonly
सदस्यता को फिर से चालू करना —

हर इवेंट टाइप के लिए, इस्तेमाल किया जा सकने वाला स्कोप होना ज़रूरी है:

  • chat.messages
  • chat.messages.readonly
  • chat.messages.reactions
  • chat.messages.reactions.readonly
  • chat.memberships
  • chat.memberships.readonly
  • chat.spaces
  • chat.spaces.readonly
  • meetings.space.created
  • meetings.space.readonly
सदस्यता मिटाना उपयोगकर्ता की पुष्टि करने के साथ, इस तरीके के लिए एक ऐसे स्कोप की ज़रूरत होती है जो सदस्यता के लिए कम से कम एक इवेंट टाइप के साथ काम करता हो.

ऐप्लिकेशन की पुष्टि करने की सुविधा के साथ (सिर्फ़ Google Chat के ऐप्लिकेशन के लिए):

  • chat.bot

इवेंट टाइप के हिसाब से स्कोप

जब उपयोगकर्ता की पुष्टि करने की सुविधा का इस्तेमाल करके Google Workspace Events API को कॉल किया जाता है, तो एक या एक से ज़्यादा स्कोप तय किए जाने चाहिए जो की सदस्यता लें.

इस टेबल में बताया गया है कि अनुमति पाने के कौनसे दायरे इस्तेमाल किए जा सकते हैं इवेंट टाइप:

इवेंट इवेंट के टाइप अनुमति के दायरे इस्तेमाल किए जा सकते हैं
Google Chat  
मैसेज पोस्ट या अपडेट किया गया है.
  • google.workspace.chat.message.v1.created
  • google.workspace.chat.message.v1.updated
  • chat.messages
  • chat.messages.readonly
किसी प्रतिक्रिया को जोड़ा या मिटाया जाता है या एक से ज़्यादा प्रतिक्रियाएं बदली जाती हैं.
  • google.workspace.chat.reaction.v1.created
  • google.workspace.chat.reaction.v1.deleted
  • google.workspace.chat.reaction.v1.batchChanged
  • chat.messages.reactions
  • chat.messages.reactions.readonly
  • chat.messages
  • chat.messages.readonly
पैसे चुकाकर ली जाने वाली सदस्यता कई सदस्यताओं को बनाया, अपडेट किया या हटाया गया हो या बदल दिए गए हैं.
  • google.workspace.chat.membership.v1.created
  • google.workspace.chat.membership.v1.updated
  • google.workspace.chat.membership.v1.deleted
  • google.workspace.chat.membership.v1.batchChanged
  • chat.memberships
  • chat.memberships.readonly
स्पेस को अपडेट किया जाता है या मिटाया जाता है.
  • google.workspace.chat.space.v1.updated
  • google.workspace.chat.space.v1.deleted
  • chat.spaces
  • chat.spaces.readonly
Google Meet  
कोई कॉन्फ़्रेंस शुरू या खत्म होती है.
  • google.workspace.meet.conference.v2.started
  • google.workspace.meet.conference.v2.ended
  • meetings.space.created
  • meetings.space.readonly
मीटिंग में हिस्सा लेने वाला कोई व्यक्ति किसी कॉन्फ़्रेंस में शामिल होता है या उसे छोड़ता है.
  • google.workspace.meet.participant.v2.joined
  • google.workspace.meet.participant.v2.left
  • meetings.space.created
  • meetings.space.readonly
रिकॉर्डिंग जनरेट की गई.
  • google.workspace.meet.recording.v2.fileGenerated
  • meetings.space.created
  • meetings.space.readonly
एक ट्रांसक्रिप्ट जनरेट की गई.
  • google.workspace.meet.transcript.v2.fileGenerated
  • meetings.space.created
  • meetings.space.readonly