Method: spaces.patch

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

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

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

  • डेवलपर प्रीव्यू में, एडमिन की अनुमति के साथ ऐप्लिकेशन की पुष्टि और अनुमति के इनमें से किसी एक दायरे का इस्तेमाल:

    • 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 हो. अगर मौजूदा स्पेस में पहले से ही 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

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