Method: spaces.patch

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

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

नीचे दिए गए पुष्टि करने के तरीकों का इस्तेमाल किया जा सकता है:

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

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

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

पाथ पैरामीटर

पैरामीटर
space.name

string

आइडेंटिफ़ायर. स्पेस में मौजूद संसाधन का नाम.

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

यहां {space}, स्पेस के लिए सिस्टम से असाइन किया गया आईडी दिखाता है. स्पेस का आईडी पाने के लिए, spaces.list() तरीके को कॉल करें या स्पेस के यूआरएल का इस्तेमाल करें. उदाहरण के लिए, अगर स्पेस का यूआरएल https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA है, तो स्पेस का आईडी AAAAAAAAA होगा.

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

पैरामीटर
updateMask

string (FieldMask format)

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

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

spaceDetails: स्पेस का ब्यौरा अपडेट करता है. इसमें ज़्यादा से ज़्यादा 150 वर्ण डाले जा सकते हैं.

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

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

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

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

permissionSettings: इसकी मदद से, स्पेस की अनुमति की सेटिंग बदली जा सकती हैं. अनुमति की सेटिंग अपडेट करते समय, सिर्फ़ permissionSettings फ़ील्ड मास्क तय किए जा सकते हैं. एक ही समय पर अन्य फ़ील्ड मास्क अपडेट नहीं किए जा सकते. permissionSettings, useAdminAccess पर काम नहीं करता. इस्तेमाल किए जा सकने वाले फ़ील्ड मास्क में ये शामिल हैं:

  • permissionSettings.manageMembersAndGroups
  • permissionSettings.modifySpaceDetails
  • permissionSettings.toggleHistory
  • permissionSettings.useAtMentionAll
  • permissionSettings.manageApps
  • permissionSettings.manageWebhooks
  • permissionSettings.replyMessages
useAdminAccess

boolean

ज़रूरी नहीं. true होने पर, यह तरीका उपयोगकर्ता के Google Workspace एडमिन के विशेषाधिकारों का इस्तेमाल करके चलता है.

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

इसके लिए, chat.admin.spaces OAuth 2.0 स्कोप की ज़रूरत होती है.

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

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

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

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

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

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

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

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

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