Method: spaces.setup

स्पेस बनाता है और उसमें चुनिंदा उपयोगकर्ताओं को जोड़ता है. कॉल करने वाले व्यक्ति को स्पेस में अपने-आप जोड़ दिया जाता है. इसे अनुरोध में, सदस्यता के तौर पर शामिल नहीं किया जाना चाहिए. उदाहरण के लिए, शुरुआती सदस्यों वाला स्पेस सेट अप करना देखें.

सदस्यों को जोड़ने के लिए, सदस्यों को SetUpSpaceRequest में सही member.name के साथ जोड़ें. किसी उपयोगकर्ता को जोड़ने के लिए, users/{user} का इस्तेमाल करें. यहां {user}, उपयोगकर्ता का ईमेल पता हो सकता है. Workspace का इस्तेमाल करने वाले एक ही संगठन के उपयोगकर्ताओं के लिए, {user}, People API का इस्तेमाल करने वाले व्यक्ति के लिए id हो सकता है. इसके अलावा, डायरेक्ट्री एपीआई में उपयोगकर्ता के लिए id भी हो सकता है. उदाहरण के लिए, अगर user@example.com का पीपल एपीआई पर्सन प्रोफ़ाइल आईडी 123456789 है, तो membership.member.name को users/user@example.com या users/123456789 पर सेट करके उपयोगकर्ता को स्पेस में जोड़ा जा सकता है.

अगर किसी स्पेस या ग्रुप चैट में कॉलर का कोई सदस्य ब्लॉक करता है या उसे कुछ सदस्य ब्लॉक कर देते हैं, तो उन सदस्यों को बनाए गए स्पेस में नहीं जोड़ा जाता.

कॉल करने वाले उपयोगकर्ता और दूसरे व्यक्ति के बीच डायरेक्ट मैसेज (DM) बनाने के लिए, उस उपयोगकर्ता की तरफ़ से एक ही सदस्यता तय करें. अगर कोई एक उपयोगकर्ता दूसरे को ब्लॉक करता है, तो अनुरोध पूरा नहीं होता और DM नहीं बनता.

कॉल करने वाले उपयोगकर्ता और कॉल करने वाले ऐप्लिकेशन के बीच डायरेक्ट मैसेज (DM) बनाने के लिए, Space.singleUserBotDm को true पर सेट करें और किसी सदस्यता के बारे में न बताएं. इस तरीके का इस्तेमाल, सिर्फ़ कॉल करने वाले ऐप्लिकेशन के साथ DM सेट अप करने के लिए किया जा सकता है. कॉल करने वाले ऐप्लिकेशन को स्पेस के सदस्य या दो लोगों के बीच मौजूदा DM सेट करने के लिए, स्पेस में उपयोगकर्ता या ऐप्लिकेशन को न्योता भेजना या जोड़ना लेख पढ़ें.

अगर दो उपयोगकर्ताओं के बीच पहले से ही कोई DM मौजूद है, तो फिर भी मौजूदा DM वापस आ जाता है. ऐसा तब भी होता है, जब कोई व्यक्ति अनुरोध करते समय एक-दूसरे को ब्लॉक करता है.

थ्रेड वाले जवाब की सुविधा वाले स्पेस का इस्तेमाल नहीं किया जा सकता. अगर स्पेस सेट अप करते समय, आपको गड़बड़ी का मैसेज ALREADY_EXISTS मिलता है, तो कोई दूसरा displayName आज़माकर देखें. Google Workspace संगठन में कोई मौजूदा स्पेस पहले से ही इस डिसप्ले नेम का इस्तेमाल कर सकता है.

इसके लिए, उपयोगकर्ता की पहचान की पुष्टि करना ज़रूरी है.

एचटीटीपी अनुरोध

POST https://chat.googleapis.com/v1/spaces:setup

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना 
{
  "space": {
    object (Space)
  },
  "requestId": string,
  "memberships": [
    {
      object (Membership)
    }
  ]
}
फ़ील्ड
space

object (Space)

ज़रूरी है. Space.spaceType फ़ील्ड को भरना ज़रूरी है.

स्पेस बनाने के लिए, Space.spaceType को SPACE पर सेट करें और Space.displayName को सेट करें. अगर स्पेस सेट अप करते समय, आपको गड़बड़ी का मैसेज ALREADY_EXISTS मिलता है, तो कोई दूसरा displayName आज़माकर देखें. Google Workspace संगठन में कोई मौजूदा स्पेस पहले से ही इस डिसप्ले नेम का इस्तेमाल कर सकता है.

ग्रुप चैट बनाने के लिए, Space.spaceType को GROUP_CHAT पर सेट करें. Space.displayName को सेट न करें.

लोगों के बीच 1:1 बातचीत करने के लिए, Space.spaceType को DIRECT_MESSAGE पर सेट करें और Space.singleUserBotDm को false पर सेट करें. Space.displayName या Space.spaceDetails को सेट न करें.

Chat ऐप्लिकेशन और किसी व्यक्ति के बीच 1:1 बातचीत करने के लिए, Space.spaceType को DIRECT_MESSAGE और Space.singleUserBotDm को true पर सेट करें. Space.displayName या Space.spaceDetails को सेट न करें.

अगर DIRECT_MESSAGE स्पेस पहले से मौजूद है, तो नया स्पेस बनाने के बजाय वह स्पेस दिखाया जाता है.
requestId

string

ज़रूरी नहीं. इस अनुरोध के लिए यूनीक आइडेंटिफ़ायर. एक रैंडम यूयूआईडी का सुझाव दिया जाता है. किसी मौजूदा अनुरोध आईडी को तय करने से, नया स्पेस बनाने के बजाय उस आईडी से बनाया गया स्पेस वापस आ जाता है. एक ही Chat ऐप्लिकेशन के किसी मौजूदा अनुरोध के आईडी को पुष्टि किए गए किसी अलग उपयोगकर्ता से तय करने पर गड़बड़ी का मैसेज मिलता है.
memberships[]

object (Membership)

ज़रूरी नहीं. Google Chat इस्तेमाल करने वाले ऐसे लोग जिन्हें स्पेस में शामिल होने का न्योता देना है. कॉल करने वाले उपयोगकर्ता को छोड़ दें, क्योंकि उन्हें अपने-आप जोड़ दिया जाता है.

फ़िलहाल, इस सेट में 20 सदस्यताएं (कॉलर के अलावा) तक शामिल की जा सकती हैं.

Membership.member फ़ील्ड में user होना चाहिए, जिसमें name की जानकारी अपने-आप भरी हुई हो (फ़ॉर्मैट: users/{user}) और type को User.Type.HUMAN पर सेट किया गया हो. स्पेस सेट अप करते समय, सिर्फ़ लोगों को जोड़ा जा सकता है. चैट ऐप्लिकेशन को कॉल करने के लिए इस्तेमाल किए जाने वाले ऐप्लिकेशन में, सिर्फ़ डायरेक्ट मैसेज सेटअप करने की सुविधा मिलती है. उपयोगकर्ता के ईमेल को {user} के उपनाम के तौर पर इस्तेमाल करके भी सदस्यों को जोड़ा जा सकता है. उदाहरण के लिए, user.name, users/example@gmail.com हो सकता है." Gmail या Google Workspace से बाहर के डोमेन के उपयोगकर्ताओं को न्योता भेजने के लिए, {user} के लिए उपयोगकर्ता के ईमेल का इस्तेमाल करना ज़रूरी है.

Space.spaceType को SPACE पर सेट करते समय ज़रूरी नहीं.

Space.spaceType को GROUP_CHAT पर सेट करने के साथ-साथ कम से कम दो सदस्यताओं पर सेट करना ज़रूरी है.

जब किसी उपयोगकर्ता के साथ Space.spaceType को DIRECT_MESSAGE पर सेट करते समय ज़रूरी होता है, तो सिर्फ़ एक सदस्यता होनी चाहिए.

चैट ऐप्लिकेशन और किसी व्यक्ति के बीच 1:1 बातचीत करते समय यह फ़ील्ड खाली होना चाहिए (जब Space.spaceType को DIRECT_MESSAGE और Space.singleUserBotDm को true पर सेट किया जाए).

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में Space का एक इंस्टेंस शामिल किया जाता है.

अनुमति के दायरे

इनमें से किसी एक OAuth दायरों की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.create

ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.