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)

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

फ़िलहाल, इस्तेमाल किए जा सकने वाले फ़ील्ड पाथ:

  • displayName (सिर्फ़ SPACE टाइप वाले स्पेस के डिसप्ले नेम को बदलने की सुविधा मिलती है. इसके अलावा, GROUP_CHAT स्पेस टाइप को SPACE में बदलने के लिए, spaceType मास्क शामिल करें. GROUP_CHAT या DIRECT_MESSAGE स्पेस के डिसप्ले नेम को अपडेट करने की कोशिश करने पर, अमान्य आर्ग्युमेंट वाली गड़बड़ी हो सकती है. अगर displayName को अपडेट करते समय आपको गड़बड़ी का मैसेज ALREADY_EXISTS मिलता है, तो कोई दूसरा displayName आज़माएं. Google Workspace संगठन में कोई मौजूदा स्पेस पहले से ही इस डिसप्ले नेम का इस्तेमाल कर सकता है.)

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

  • spaceDetails

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

  • डेवलपर के लिए झलक: accessSettings.audience (इसमें स्पेस की ऐक्सेस सेटिंग बदली जा सकती है. अगर ऐक्सेस सेटिंग में कोई ऑडियंस तय नहीं की गई है, तो स्पेस की ऐक्सेस सेटिंग को 'सीमित ऐक्सेस' पर अपडेट कर दिया जाता है. चेतावनी: फ़ील्ड के अन्य सभी पाथ के साथ म्युचुअली एक्सक्लूसिव.)

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

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

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

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

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

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

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

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