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)

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

स्पेस के लिए, इन फ़ील्ड को अपडेट किया जा सकता है:

  • spaceDetails

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

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

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

  • accessSettings.audience: इसकी ऐक्सेस सेटिंग अपडेट की जाती है कि स्पेस को कौन खोज सकता है, स्पेस में शामिल हो सकता है, और नाम वाले स्पेस में मैसेज की झलक देख सकता है. यह वही स्पेस है जिसमें spaceType फ़ील्ड SPACE है. अगर मौजूदा स्पेस में टारगेट ऑडियंस हैं, तो ऑडियंस को हटाया जा सकता है. साथ ही, इस फ़ील्ड मास्क की वैल्यू को हटाकर, स्पेस के ऐक्सेस पर पाबंदी लगाई जा सकती है. किसी स्पेस के ऐक्सेस की सेटिंग अपडेट करने के लिए, यह ज़रूरी है कि पुष्टि करने वाला उपयोगकर्ता, स्पेस मैनेजर हो. साथ ही, उसे अपने अनुरोध में शामिल अन्य सभी फ़ील्ड मास्क हटाने की ज़रूरत न पड़े. अगर स्पेस इंपोर्ट मोड में है, तो इस फ़ील्ड को अपडेट नहीं किया जा सकता. ज़्यादा जानने के लिए, स्पेस को कुछ खास उपयोगकर्ताओं के लिए उपलब्ध कराना लेख पढ़ें. 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

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