Google Workspace का इस्तेमाल करने वाले संगठन के कुछ उपयोगकर्ताओं के लिए, Google Chat पर मौजूद स्पेस को खोजे जाने लायक बनाना

इस पेज पर, Google Chat API का इस्तेमाल करके, Google Workspace संगठन के कुछ उपयोगकर्ताओं के साथ Google Chat स्पेस शेयर करने का तरीका बताया गया है. इससे वे स्पेस को खोज सकते हैं, उसमें शामिल हो सकते हैं, और उसके सदस्यों को देख सकते हैं.

अपने संगठन के उन उपयोगकर्ताओं को तय करने के लिए टारगेट ऑडियंस बनाई जाती हैं जो किसी स्पेस को ढूंढ सकते हैं, उसमें शामिल हो सकते हैं, और उसके सदस्यों को देख सकते हैं. टारगेट ऑडियंस लोगों का एक ग्रुप होता है. जैसे, कोई खास विभाग या पूरा संगठन. इस ग्रुप के साथ Chat स्पेस शेयर किया जा सकता है. इससे आपको यह तय करने का ज़्यादा कंट्रोल मिलता है कि कौन स्पेस और उसकी जानकारी को ऐक्सेस कर सकता है. टारगेट ऑडियंस की मदद से, स्पेस की सदस्यताएं मैनेज और पसंद के मुताबिक बनाई जा सकती हैं. इसके लिए, आपको हर उपयोगकर्ता को स्पेस में शामिल होने का न्योता भेजने की ज़रूरत नहीं होती. ज़्यादा जानकारी के लिए, टारगेट ऑडियंस के बारे में जानकारी लेख पढ़ें.

सिर्फ़ नाम वाले स्पेस को टारगेट ऑडियंस के लिए खोजे जाने की सुविधा चालू की जा सकती है. टारगेट ऑडियंस के साथ, डायरेक्ट मैसेज या ग्रुप बातचीत जैसे अन्य स्पेस टाइप शेयर नहीं किए जा सकते.

ज़रूरी शर्तें

• Business या Enterprise वर्शन वाला Google Workspace खाता, जिसमें Google Chat का ऐक्सेस हो. आपके खाते के पास, Google Workspace संगठन के लिए सुपर एडमिन की भूमिका होनी चाहिए.
• टारगेट ऑडियंस, जिसे Chat में ऐक्सेस किया जा सकता है. टारगेट ऑडियंस बनाने के लिए, टारगेट ऑडियंस बनाना लेख पढ़ें. अगर आपको किसी मौजूदा टारगेट ऑडियंस को Chat स्पेस के लिए उपलब्ध कराना है, तो Chat के लिए स्पेस का ऐक्सेस सेट अप करना लेख पढ़ें.
• आपको उपयोगकर्ता की पुष्टि के साथ, Google Chat API को कॉल करना होगा.

टारगेट ऑडियंस का आईडी पाना

टारगेट ऑडियंस का आईडी पाने के लिए, यह तरीका अपनाएं:

1. Google Admin console में, मेन्यू menu > डायरेक्ट्री > टारगेट ऑडियंस पर जाएं.

   टारगेट ऑडियंस पर जाएं

2. टारगेट ऑडियंस टेबल में, टारगेट ऑडियंस के नाम फ़ील्ड पर क्लिक करें.

3. पेज के यूआरएल में टारगेट ऑडियंस का आईडी ढूंढें. यूआरएल का फ़ॉर्मैट https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID है. इसमें TARGET_AUDIENCE_ID, टारगेट ऑडियंस के लिए अक्षरों और अंकों से बना आईडी है.

अगले सेक्शन में, टारगेट ऑडियंस के आईडी का इस्तेमाल करके, ऐसा स्पेस बनाया जाता है जिसे टारगेट ऑडियंस खोज सके. इसके अलावा, मौजूदा स्पेस को अपडेट करके, उसे टारगेट ऑडियंस के लिए खोजे जाने लायक बनाया जा सकता है.

टारगेट ऑडियंस और ज़्यादा सटीक अनुमतियां तय करना

ऐक्सेस करने की खास अनुमतियों वाला स्पेस बनाने के लिए, Space रिसॉर्स पर create या setup तरीके का इस्तेमाल करें. किसी मौजूदा स्पेस के लिए अनुमतियां अपडेट करने के लिए, update तरीके का इस्तेमाल करें. सिर्फ़ नाम वाले स्पेस को टारगेट ऑडियंस के साथ शेयर किया जा सकता है. इसलिए, स्पेस का टाइप (spaceType फ़ील्ड में दिखाया गया है) SPACE होना चाहिए.

यह तय करने के लिए कि किसी स्पेस को कौन ढूंढ सकता है, उसमें शामिल हो सकता है या उसके सदस्यों को देख सकता है, Space संसाधन में AccessSettings ऑब्जेक्ट शामिल करें. ऑब्जेक्ट में, accessPermissionSettings फ़ील्ड का इस्तेमाल करके, यहां दी गई एक या उससे ज़्यादा अनुमतियां तय करें:

• ढूंढा जा सकता है: discoverSpaceSetting का इस्तेमाल करके यह तय करें कि कौन स्पेस का नाम और ब्यौरा ढूंढ सकता है. साथ ही, Google Chat में इसे ब्राउज़ कर सकता है. डिस्कवरी कैंपेन के लिए, एक से ज़्यादा टारगेट ऑडियंस तय की जा सकती हैं.
• शामिल होने की अनुमति: joinSpaceSetting का इस्तेमाल करके यह तय करें कि कौनसे लोग, स्पेस में शामिल हो सकते हैं. इसके लिए, उन्हें न्योता भेजने की ज़रूरत नहीं होगी. साथ ही, वे स्पेस में मौजूद मैसेज की झलक देख सकते हैं. जो लोग किसी स्पेस में शामिल हो सकते हैं उनके पास उसे खोजने का विकल्प भी होना चाहिए. Google Chat में, इस अनुमति के लिए सिर्फ़ एक टारगेट ऑडियंस को चुना जा सकता है.
• सदस्यता देखें: viewSpaceMembershipSetting का इस्तेमाल करके यह तय करें कि स्पेस में सदस्यों की सूची कौन देख सकता है. स्पेस की सदस्यता देखने की अनुमति रखने वाले लोगों की जानकारी अपडेट करते समय, accessSettings.accessPermissionSettings.viewSpaceMembershipSetting को permissionSettings.viewSpaceMembership के साथ updateMask और अनुरोध के मुख्य हिस्से, दोनों में शामिल करना ज़रूरी है. जब viewSpaceMembershipSetting में टारगेट ऑडियंस को कॉन्फ़िगर किया जाता है, तब सभी सदस्यों को viewSpaceMembership की अनुमति दी जानी चाहिए. जैसे, managersAllowed, assistantManagersAllowed, और membersAllowed को true पर सेट किया जाना चाहिए.

यहां दिए गए उदाहरण में बताया गया है कि कैसे किसी स्पेस को दो टारगेट ऑडियंस के लिए खोजे जाने लायक बनाया जा सकता है. साथ ही, यह भी बताया गया है कि इनमें से किसी एक ऑडियंस को स्पेस में शामिल होने की अनुमति कैसे दी जा सकती है. इसके अलावा, यह भी बताया गया है कि सभी सदस्यों और चुनी गई टारगेट ऑडियंस को सदस्यों की सूची देखने की अनुमति कैसे दी जा सकती है:

{
  "accessSettings": {
    "accessPermissionSettings": {
      "discoverSpaceSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } },
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_2" } }
        ]
      },
      "joinSpaceSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } }
        ]
      },
      "viewSpaceMembershipSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } },
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_2" } }
        ]
      }
    }
  },
  "permissionSettings": {
    "viewSpaceMembership": {
      "managersAllowed": true,
      "assistantManagersAllowed": true,
      "membersAllowed": true
    }
  }
}

TARGET_AUDIENCE_ID_1 और TARGET_AUDIENCE_ID_2 की जगह, टारगेट ऑडियंस का वह आईडी डालें जो आपको टारगेट ऑडियंस का आईडी पाएं में मिला था. अगर आपको Google Workspace संगठन के लिए, Chat स्पेस शेयर करने की डिफ़ॉल्ट सेटिंग का इस्तेमाल करना है, तो default से बदलें.

पुराने सिस्टम के साथ काम करने की सुविधा के लिए, audience फ़ील्ड का इस्तेमाल करें

पुराने सिस्टम के साथ काम करने के लिए, audience फ़ील्ड का इस्तेमाल जारी रखा जा सकता है. इससे, स्पेस में शामिल होने के लिए एक टारगेट ऑडियंस तय की जा सकती है. हालांकि, हमारा सुझाव है कि आप इसके बजाय टारगेट ऑडियंस और ज़्यादा बारीकी से तय की गई अनुमतियां तय करें.

audience फ़ील्ड को सेट करने का मतलब, joinSpaceSetting में टारगेट ऑडियंस तय करना है:

  "accessSettings": {
    "audience": "audiences/TARGET_AUDIENCE_ID"
  }

TARGET_AUDIENCE_ID की जगह, टारगेट ऑडियंस का वह आईडी डालें जो आपको टारगेट ऑडियंस का आईडी पाना में मिला था. अगर आपको Google Workspace संगठन के लिए, Chat स्पेस शेयर करने की डिफ़ॉल्ट सेटिंग का इस्तेमाल करना है, तो default से बदलें.

एपीआई से मिले जवाबों में ऐक्सेस सेटिंग के बारे में जानकारी

जब आपको स्पेस मिलते हैं या उनकी सूची मिलती है, तो जवाब में मौजूद AccessSettings ऑब्जेक्ट, स्पेस के लिए सेट की गई विस्तृत अनुमतियों को दिखाता है.

AccessSettings में मौजूद इन फ़ील्ड से, किसी स्पेस को खोजने और उसमें शामिल होने की अनुमतियों के बारे में पता चलता है:

• accessState: यह फ़ील्ड, डिस्कवरी की अनुमतियों (discoverSpaceSetting) से मिलता है. अगर एक या उससे ज़्यादा टारगेट ऑडियंस को डिस्कवरी की अनुमति दी जाती है, तो इस फ़ील्ड की वैल्यू DISCOVERABLE होती है. अगर ऐसा नहीं है, तो यह PRIVATE होता है.
• audience: यह फ़ील्ड, खास तौर पर शामिल होने की अनुमतियों (joinSpaceSetting) के लिए मैप किया गया है. अगर किसी एक टारगेट ऑडियंस को शामिल होने की अनुमति दी जाती है, तो इस फ़ील्ड में उस टारगेट ऑडियंस का संसाधन नाम शामिल होता है.

ऐसा स्पेस जिसमें संगठन के सभी सदस्य शामिल हो सकते हैं, लेकिन ऑडियंस को शामिल होने की अनुमति नहीं है

ऐसा हो सकता है कि कोई स्पेस, टारगेट ऑडियंस को दिख रहा हो, लेकिन उसमें सीधे तौर पर शामिल न हुआ जा सके. उदाहरण के लिए, अगर उपयोगकर्ताओं को स्पेस में शामिल होने के लिए साफ़ तौर पर न्योता भेजा जाना ज़रूरी है.

इस मामले में, AccessSettings ऑब्जेक्ट की ये वैल्यू हैं:

• accessState: DISCOVERABLE
• audience: शामिल नहीं किया गया या null

अगर आपको accessState को DISCOVERABLE पर सेट किया गया दिखता है, लेकिन audience मौजूद नहीं है, तो इसका मतलब है कि discoverSpaceSetting में बताई गई टारगेट ऑडियंस, स्पेस को ढूंढ सकती हैं. हालांकि, इसमें सिर्फ़ न्योता पाकर शामिल हुआ जा सकता है. यह देखने के लिए कि स्पेस को कौनसी टारगेट ऑडियंस ढूंढ सकती हैं, accessPermissionSettings.discoverSpaceSetting फ़ील्ड देखें.

मिलते-जुलते विषय

टारगेट ऑडियंस के बारे में ज़्यादा जानने के लिए, ये गाइड देखें:

• टारगेट ऑडियंस बनाना
• Chat में शेयर करने की सुविधा सेट अप करना
• अलग-अलग ऐक्सेस लेवल वाले स्पेस बनाना

Chat API का इस्तेमाल करके स्पेस बनाने या अपडेट करने के बारे में ज़्यादा जानने के लिए, यहां दी गई गाइड देखें:

• कोई स्पेस बनाना
• कोई स्पेस सेट अप करना
• स्पेस अपडेट करना