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

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

अपने संगठन के उन उपयोगकर्ताओं के बारे में बताने के लिए जो किसी स्पेस को ढूंढ सकते हैं और उसमें शामिल हो सकते हैं, टारगेट ऑडियंस बनाएं. टारगेट ऑडियंस लोगों का एक ग्रुप होता है. जैसे, खास डिपार्टमेंट या पूरा संगठन. इस ग्रुप के साथ 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आपकी टारगेट ऑडियंस का अल्फ़ान्यूमेरिक आईडी होता है.

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

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

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

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

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

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

  "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" } }
        ]
      }
    }
  }

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

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

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

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

  "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 का इस्तेमाल करके, स्पेस बनाने या अपडेट करने के बारे में ज़्यादा जानने के लिए, ये गाइड देखें:

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