Method: spaces.patch

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

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

इन तरह के authentication के साथ काम करता है:

  • ऐप्लिकेशन की पुष्टि के लिए, एडमिन की मंज़ूरी और अनुमति के लिए इनमें से कोई एक स्कोप:

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

  • उपयोगकर्ता की पुष्टि के लिए, अनुमति के इन स्कोप में से किसी एक का इस्तेमाल करें:

    • https://www.googleapis.com/auth/chat.spaces
    • https://www.googleapis.com/auth/chat.import (सिर्फ़ इंपोर्ट मोड वाले स्पेस)
    • उपयोगकर्ता की पुष्टि करने पर, एडमिन के खास अधिकार मिलते हैं. ऐसा तब होता है, जब एडमिन खाता पुष्टि करता है, useAdminAccess true होता है, और अनुमति के इन स्कोप का इस्तेमाल किया जाता है:
      • https://www.googleapis.com/auth/chat.admin.spaces

ऐप्लिकेशन की पुष्टि करने की सुविधा से जुड़ी ये सीमाएं हैं:

  • space.predefined_permission_settings या space.permission_settings में से किसी एक को अपडेट करने के लिए, ऐप्लिकेशन को स्पेस बनाने वाला ऐप्लिकेशन होना चाहिए.
  • ऐप्लिकेशन की पुष्टि करने के लिए, space.access_settings.audience को अपडेट करने की सुविधा उपलब्ध नहीं है.

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

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 में बदला जा सकता है. अपडेट मास्क में spaceType के साथ displayName को शामिल करें. साथ ही, पक्का करें कि तय की गई जगह का डिसप्ले नेम खाली न हो और वह SPACE स्पेस टाइप का हो. डिसप्ले नेम अपडेट करते समय, तय किए गए स्पेस में spaceType मास्क और SPACE टाइप शामिल करना ज़रूरी नहीं है. ऐसा तब होता है, जब मौजूदा स्पेस में पहले से ही 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

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