Method: spaces.patch

स्पेस को अपडेट करता है. उदाहरण के लिए, स्पेस अपडेट करना लेख पढ़ें.

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

उपयोगकर्ता की पुष्टि ज़रूरी है.

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

PATCH https://chat.googleapis.com/v1/{space.name=spaces/*}

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

पाथ पैरामीटर

पैरामीटर
space.name

string

स्पेस में मौजूद संसाधन का नाम.

फ़ॉर्मैट: spaces/{space}

क्वेरी पैरामीटर

पैरामीटर
updateMask

string (FieldMask format)

ज़रूरी है. अपडेट किए गए फ़ील्ड पाथ, अगर एक से ज़्यादा फ़ील्ड हैं, तो उन्हें कॉमा से अलग किया जाता है.

फ़िलहाल, इन फ़ील्ड पाथ का इस्तेमाल किया जा सकता है:

  • displayName (सिर्फ़ SPACE टाइप वाले स्पेस का डिसप्ले नेम बदलने की सुविधा मिलती है. इसके अलावा, GROUP_CHAT स्पेस टाइप को SPACE में बदलने के लिए, spaceType मास्क शामिल करने पर भी ऐसा किया जा सकता है. GROUP_CHAT या DIRECT_MESSAGE स्पेस का डिसप्ले नेम अपडेट करने की कोशिश करने पर, आर्ग्युमेंट से जुड़ी गड़बड़ी अमान्य हो जाएगी. अगर displayName को अपडेट करते समय आपको गड़बड़ी का मैसेज ALREADY_EXISTS मिलता है, तो कोई दूसरा displayName आज़माएं. ऐसा हो सकता है कि Google Workspace का इस्तेमाल करने वाले संगठन में मौजूद कोई स्पेस, पहले से ही इस डिसप्ले नेम का इस्तेमाल कर रहा हो.)

  • spaceType (सिर्फ़ GROUP_CHAT स्पेस के टाइप को SPACE में बदलने की सुविधा काम करती है. अपडेट मास्क में, displayName को spaceType के साथ शामिल करें. साथ ही, पक्का करें कि बताए गए स्पेस में कोई खाली डिसप्ले नेम और SPACE स्पेस टाइप हो. अगर मौजूदा स्पेस में पहले से ही SPACE टाइप की सुविधा है, तो डिसप्ले नेम को अपडेट करते समय, बताए गए स्पेस में spaceType मास्क और SPACE टाइप को शामिल करना ज़रूरी नहीं है. स्पेस के टाइप को दूसरे तरीकों से अपडेट करने की कोशिश करने पर, अमान्य तर्क से जुड़ी गड़बड़ी मिलती है. spaceType के पास एडमिन ऐक्सेस नहीं है.

  • spaceDetails

  • spaceHistoryState (अगर संगठन ने उपयोगकर्ताओं को इतिहास की सेटिंग बदलने की अनुमति दी है, तो स्पेस के लिए इतिहास को चालू या बंद करने की सुविधा काम करती है. चेतावनी: दूसरे सभी फ़ील्ड पाथ के साथ म्यूचुअली एक्सक्लूसिव. spaceHistoryState के पास एडमिन ऐक्सेस नहीं है.

  • डेवलपर की झलक: accessSettings.audience (किसी स्पेस की ऐक्सेस सेटिंग में बदलाव किया जा सकता है. अगर ऐक्सेस सेटिंग में कोई ऑडियंस तय नहीं की गई है, तो स्पेस की ऐक्सेस सेटिंग को 'प्रतिबंधित' पर सेट कर दिया जाता है. चेतावनी: दूसरे सभी फ़ील्ड पाथ के साथ म्यूचुअली एक्सक्लूसिव. accessSettings.audience के पास एडमिन ऐक्सेस नहीं है.

  • डेवलपर की झलक: स्पेस की अनुमति सेटिंग को बदलने में मदद मिलती है. साथ ही, ये फ़ील्ड पाथ इस्तेमाल किए जा सकते हैं: permissionSettings.manage_members_and_groups, permissionSettings.modify_space_details, permissionSettings.toggle_history, permissionSettings.use_at_mention_all, permissionSettings.manage_apps, permissionSettings.manage_webhooks, permissionSettings.reply_messages (चेतावनी: बिना अनुमति वाले अन्य सभी सेटिंग फ़ील्ड पाथ के साथ इन्हें अलग से इस्तेमाल नहीं किया जा सकता). permissionSettings के पास एडमिन ऐक्सेस नहीं है.
useAdminAccess

boolean

true के साथ, यह तरीका उपयोगकर्ता के Google Workspace एडमिन के खास अधिकारों का इस्तेमाल करके चलता है.

कॉल करने वाला उपयोगकर्ता, Google Workspace एडमिन होना चाहिए. उसके पास, चैट और स्पेस में होने वाली बातचीत को मैनेज करने का अधिकार होना चाहिए.

chat.admin.spaces OAuth 2.0 स्कोप की ज़रूरत होती है.

एडमिन ऐक्सेस का इस्तेमाल करने पर, FieldMask की कुछ वैल्यू का इस्तेमाल नहीं किया जा सकता. ज़्यादा जानकारी के लिए, updateMask का ब्यौरा देखें.

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

अनुरोध के मुख्य भाग में Space का उदाहरण है.

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

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

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

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

  • https://www.googleapis.com/auth/chat.admin.spaces
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces

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