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: स्पेस के ब्यौरे और दिशा-निर्देशों को अपडेट करता है. अपडेट के अनुरोध में, आपको ब्यौरा और दिशा-निर्देश, दोनों को SpaceDetails के तौर पर पास करना होगा. अगर आपको सिर्फ़ एक फ़ील्ड अपडेट करना है, तो दूसरे फ़ील्ड के लिए मौजूदा वैल्यू पास करें.

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

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

  • accessSettings.access_permission_settings.discoverSpaceSetting
  • accessSettings.access_permission_settings.joinSpaceSetting

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

  • 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

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