- संसाधन: स्पेस
- तरीके
संसाधन: स्पेस
Google Chat में मौजूद कोई स्पेस. स्पेस, दो या उससे ज़्यादा लोगों के बीच की बातचीत होती है. इसके अलावा, यह किसी व्यक्ति और Chat ऐप्लिकेशन के बीच की 1:1 बातचीत भी हो सकती है.
| JSON के काेड में दिखाना |
|---|
{ "name": string, "type": enum ( |
| फ़ील्ड | |
|---|---|
name |
आइडेंटिफ़ायर. स्पेस का संसाधन नाम. फ़ॉर्मैट: यहां |
type |
सिर्फ़ आउटपुट के लिए. इस्तेमाल बंद कर दिया गया है: इसके बजाय, |
spaceType |
ज़रूरी नहीं. स्पेस किस तरह का है. स्पेस बनाते समय या स्पेस के टाइप को अपडेट करते समय यह फ़ील्ड ज़रूरी होता है. सिर्फ़ अन्य इस्तेमाल के लिए आउटपुट. |
singleUserBotDm |
ज़रूरी नहीं. क्या स्पेस, Chat ऐप्लिकेशन और किसी व्यक्ति के बीच का डीएम है. |
threaded |
सिर्फ़ आउटपुट के लिए. इस्तेमाल बंद कर दिया गया है: इसके बजाय, |
displayName |
ज़रूरी नहीं. स्पेस का डिसप्ले नेम. डायरेक्ट मैसेज के लिए, यह फ़ील्ड खाली हो सकता है. इसमें ज़्यादा से ज़्यादा 128 वर्ण इस्तेमाल किए जा सकते हैं. |
externalUserAllowed |
ज़रूरी नहीं. बदला नहीं जा सकता. इस स्पेस में, Google Chat इस्तेमाल करने वाले किसी भी व्यक्ति को सदस्य के तौर पर शामिल होने की अनुमति है या नहीं. Google Workspace संगठन में स्पेस बनाते समय इनपुट. इन स्थितियों में स्पेस बनाते समय, इस फ़ील्ड को शामिल न करें:
मौजूदा स्पेस के लिए, यह फ़ील्ड सिर्फ़ आउटपुट के लिए होता है. |
spaceThreadingState |
सिर्फ़ आउटपुट के लिए. Chat स्पेस में थ्रेडिंग की स्थिति. |
spaceDetails |
ज़रूरी नहीं. स्पेस के बारे में जानकारी, जिसमें ब्यौरा और नियम शामिल हैं. |
spaceHistoryState |
ज़रूरी नहीं. इस स्पेस में मौजूद मैसेज और थ्रेड के लिए, मैसेज के इतिहास की स्थिति. |
importMode |
ज़रूरी नहीं. यह स्पेस, Google Workspace में डेटा माइग्रेट करने के दौरान
|
createTime |
ज़रूरी नहीं. बदला नहीं जा सकता. Chat में बनाए गए स्पेस के लिए, स्पेस बनाने का समय. इस फ़ील्ड का इस्तेमाल सिर्फ़ आउटपुट के लिए किया जाता है. हालांकि, इंपोर्ट मोड वाले स्पेस में इसका इस्तेमाल किया जा सकता है. इंपोर्ट मोड वाले स्पेस के लिए, इस फ़ील्ड को उस हिस्टोरिकल टाइमस्टैंप पर सेट करें जिस पर सोर्स में स्पेस बनाया गया था. इससे स्पेस के बनाए जाने का ओरिजनल समय सुरक्षित रहेगा. यह फ़ील्ड, आउटपुट में सिर्फ़ तब दिखता है, जब |
lastActiveTime |
सिर्फ़ आउटपुट के लिए. स्पेस में भेजे गए आखिरी मैसेज का टाइमस्टैंप. |
adminInstalled |
सिर्फ़ आउटपुट के लिए. Chat ऐप्लिकेशन के साथ डायरेक्ट मैसेज (डीएम) स्पेस के लिए, यह जानकारी मिलती है कि स्पेस को Google Workspace एडमिन ने बनाया है या नहीं. एडमिन, अपने संगठन के उपयोगकर्ताओं की ओर से, Chat ऐप्लिकेशन के साथ डायरेक्ट मैसेज की सुविधा को इंस्टॉल और सेट अप कर सकते हैं. एडमिन के ज़रिए इंस्टॉल करने की सुविधा के लिए, आपके Chat ऐप्लिकेशन में डायरेक्ट मैसेज भेजने की सुविधा होनी चाहिए. |
membershipCount |
सिर्फ़ आउटपुट के लिए. सदस्यता लेने वाले लोगों की संख्या, सदस्यता के टाइप के हिसाब से ग्रुप की गई है. |
accessSettings |
ज़रूरी नहीं. इससे स्पेस की ऐक्सेस सेटिंग के बारे में पता चलता है. यह फ़ील्ड सिर्फ़ तब दिखता है, जब |
spaceUri |
सिर्फ़ आउटपुट के लिए. किसी उपयोगकर्ता के लिए, स्पेस को ऐक्सेस करने का यूआरआई. |
importModeExpireTime |
सिर्फ़ आउटपुट के लिए. वह समय जब इंपोर्ट मोड में रहने पर, सिस्टम स्पेस को अपने-आप मिटा देगा. इंपोर्ट मोड में बनाए गए हर स्पेस को, इस मोड से बाहर निकलना होगा. इसके लिए, यह फ़ील्ड सिर्फ़ उन स्पेस के लिए भरा जाता है जिन्हें इंपोर्ट मोड का इस्तेमाल करके बनाया गया था. |
customer |
ज़रूरी नहीं. बदला नहीं जा सकता. स्पेस के डोमेन का ग्राहक आईडी. इस पैरामीटर की वैल्यू सिर्फ़ तब ज़रूरी होती है, जब ऐप्लिकेशन की पुष्टि की सुविधा के साथ स्पेस बनाया जा रहा हो और यह यह फ़ील्ड, डायरेक्ट मैसेज (डीएम) के लिए नहीं भरा जाता. साथ ही, इसे तब भी नहीं भरा जाता, जब स्पेस को Google Workspace का इस्तेमाल न करने वाले लोग बनाते हैं. |
इससे किसी स्पेस की अनुमति की सेटिंग के बारे में पता चलता है. यह फ़ील्ड सिर्फ़ तब दिखता है, जब space_type SPACE हो. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: |
|
predefinedPermissionSettings |
ज़रूरी नहीं. सिर्फ़ इनपुट के लिए. स्पेस के लिए अनुमतियों की पहले से तय की गई सेटिंग. इन्हें सिर्फ़ स्पेस बनाते समय डाला जा सकता है. अगर इस फ़ील्ड को सेट नहीं किया गया है, तो साथ मिलकर काम करने के लिए एक स्पेस बनाया जाता है. स्पेस बनाने के बाद, सेटिंग अनुमति की पहले से तय की गई सेटिंग का इस्तेमाल करने पर, ये काम किए जा सकते हैं:
|
permissionSettings |
ज़रूरी नहीं. मौजूदा स्पेस के लिए, स्पेस की अनुमति की सेटिंग. स्पेस की अनुमतियों की सटीक सेटिंग को अपडेट करने के लिए इनपुट. इससे अनुमतियों की मौजूदा सेटिंग बदल जाती हैं. इस विकल्प से, अनुमति की मौजूदा सेटिंग की सूची दिखती है. अनुमति सेटिंग को पढ़ने और अपडेट करने की सुविधा इनके साथ काम करती है:
|
| एक-दूसरे से अलग फ़ील्ड के आखिर में. | |
टाइप
इस्तेमाल बंद कर दिया गया है: इसके बजाय, SpaceType का इस्तेमाल करें.
| Enums | |
|---|---|
TYPE_UNSPECIFIED |
बुक किया गया. |
ROOM |
दो या उससे ज़्यादा इंसानों के बीच बातचीत. |
DM |
किसी इंसान और चैट ऐप्लिकेशन के बीच की गई सीधी बातचीत, जिसमें सभी मैसेज फ़्लैट हैं. ध्यान दें कि इसमें दो लोगों के बीच हुए डायरेक्ट मैसेज शामिल नहीं हैं. |
SpaceType
स्पेस किस तरह का है. स्पेस बनाते या अपडेट करते समय यह फ़ील्ड ज़रूरी होता है. सिर्फ़ अन्य इस्तेमाल के लिए आउटपुट.
| Enums | |
|---|---|
SPACE_TYPE_UNSPECIFIED |
बुक किया गया. |
SPACE |
यह एक ऐसी जगह है जहां लोग मैसेज भेजते हैं, फ़ाइलें शेयर करते हैं, और साथ मिलकर काम करते हैं. SPACE में Chat ऐप्लिकेशन शामिल किए जा सकते हैं. |
GROUP_CHAT |
तीन या इससे ज़्यादा लोगों के बीच ग्रुप बातचीत. GROUP_CHAT में Chat ऐप्लिकेशन शामिल किए जा सकते हैं. |
DIRECT_MESSAGE |
दो लोगों के बीच हुई बातचीत या किसी व्यक्ति और Chat ऐप्लिकेशन के बीच हुई बातचीत. |
SpaceThreadingState
इससे Chat स्पेस में थ्रेडिंग की स्थिति का टाइप पता चलता है.
| Enums | |
|---|---|
SPACE_THREADING_STATE_UNSPECIFIED |
बुक किया गया. |
THREADED_MESSAGES |
ऐसे स्पेस जिनमें मैसेज थ्रेड की सुविधा काम करती हो. जब उपयोगकर्ता किसी मैसेज का जवाब देते हैं, तो वे थ्रेड में जवाब दे सकते हैं. इससे उनका जवाब, ओरिजनल मैसेज के कॉन्टेक्स्ट में रहता है. |
GROUPED_MESSAGES |
नाम वाले स्पेस, जहां बातचीत को विषय के हिसाब से व्यवस्थित किया जाता है. विषयों और उनके जवाबों को एक साथ ग्रुप किया जाता है. |
UNTHREADED_MESSAGES |
ऐसे स्पेस जिनमें मैसेज थ्रेडिंग की सुविधा काम नहीं करती. इस स्पेस थ्रेडिंग की स्थिति का इस्तेमाल सिर्फ़ खास मामलों में किया जाता है. जैसे:
|
SpaceDetails
स्पेस के बारे में जानकारी, जिसमें ब्यौरा और नियम शामिल हैं.
| JSON के काेड में दिखाना |
|---|
{ "description": string, "guidelines": string } |
| फ़ील्ड | |
|---|---|
description |
ज़रूरी नहीं. स्पेस के बारे में जानकारी. उदाहरण के लिए, स्पेस में चर्चा के विषय, स्पेस के मकसद या स्पेस में शामिल लोगों के बारे में जानकारी दें. इसमें ज़्यादा से ज़्यादा 4,096 वर्ण इस्तेमाल किए जा सकते हैं. |
guidelines |
ज़रूरी नहीं. स्पेस के नियम, उम्मीदें, और शिष्टाचार. इसमें ज़्यादा से ज़्यादा 5,000 वर्ण हो सकते हैं. |
HistoryState
मैसेज और स्पेस के इतिहास की स्थिति. इससे यह तय होता है कि मैसेज और बातचीत की थ्रेड बनने के बाद, उन्हें कितने समय तक सेव रखा जाएगा.
| Enums | |
|---|---|
HISTORY_STATE_UNSPECIFIED |
डिफ़ॉल्ट मान. इस्तेमाल न करें. |
HISTORY_OFF |
इतिहास बंद है. मैसेज और थ्रेड 24 घंटे तक सेव रहते हैं. |
HISTORY_ON |
इतिहास चालू है. संगठन के Vault में निजी डेटा के रखरखाव के नियमों में यह तय किया जाता है कि मैसेज और थ्रेड को कितने समय तक सेव रखा जाए. |
MembershipCount
यह स्पेस की सदस्यताओं की संख्या दिखाता है. इन्हें कैटगरी के हिसाब से ग्रुप किया जाता है.
| JSON के काेड में दिखाना |
|---|
{ "joinedDirectHumanUserCount": integer, "joinedGroupCount": integer } |
| फ़ील्ड | |
|---|---|
joinedDirectHumanUserCount |
सिर्फ़ आउटपुट के लिए. उन उपयोगकर्ताओं की संख्या जिन्होंने सीधे तौर पर स्पेस में शामिल होने का अनुरोध किया है. इसमें उन उपयोगकर्ताओं को शामिल नहीं किया जाता जो किसी ग्रुप में शामिल होने के बाद स्पेस में शामिल हुए हैं. |
joinedGroupCount |
सिर्फ़ आउटपुट के लिए. उन सभी ग्रुप की संख्या जिन्होंने सीधे तौर पर स्पेस में शामिल होने का अनुरोध किया है. |
AccessSettings
इससे स्पेस की ऐक्सेस सेटिंग के बारे में पता चलता है.
| JSON के काेड में दिखाना |
|---|
{ "accessState": enum ( |
| फ़ील्ड | |
|---|---|
accessState |
सिर्फ़ आउटपुट के लिए. इससे स्पेस के ऐक्सेस की स्थिति के बारे में पता चलता है. |
audience |
ज़रूरी नहीं. टारगेट ऑडियंस का संसाधन नाम. इस ऑडियंस के सदस्य, स्पेस को ढूंढ सकते हैं, उसमें शामिल हो सकते हैं, और उसमें मौजूद मैसेज की झलक देख सकते हैं. अगर यह विकल्प सेट नहीं किया जाता है, तो सिर्फ़ वे उपयोगकर्ता या Google ग्रुप स्पेस को ऐक्सेस कर सकते हैं जिन्हें स्पेस में शामिल होने का न्योता दिया गया है या जोड़ा गया है. ज़्यादा जानकारी के लिए, किसी स्पेस को टारगेट ऑडियंस के लिए खोजे जाने लायक बनाना लेख पढ़ें. फ़ॉर्मैट: Google Workspace संगठन के लिए डिफ़ॉल्ट टारगेट ऑडियंस का इस्तेमाल करने के लिए, इसे टारगेट ऑडियंस के बारे में जानकारी से ये फ़ायदे मिलते हैं:
ऐप्लिकेशन की पुष्टि करने के लिए, टारगेट ऑडियंस सेट करने के लिए, उपयोगकर्ता की पुष्टि करना ज़रूरी है. |
accessPermissionSettings |
ज़रूरी नहीं. स्पेस के लिए, ऐक्सेस करने की अनुमति से जुड़ी सेटिंग. स्पेस बनाते समय टारगेट ऑडियंस सेट करने के लिए, अपने अनुरोध में |
AccessState
इससे स्पेस के ऐक्सेस की स्थिति के बारे में पता चलता है.
| Enums | |
|---|---|
ACCESS_STATE_UNSPECIFIED |
इस एपीआई में, ऐक्सेस की स्थिति के बारे में जानकारी नहीं है या यह सुविधा काम नहीं करती. |
PRIVATE |
सिर्फ़ वे उपयोगकर्ता या Google ग्रुप स्पेस को ढूंढ सकते हैं और उसे ऐक्सेस कर सकते हैं जिन्हें अन्य उपयोगकर्ताओं या Google Workspace एडमिन ने स्पेस में जोड़ा है या उसमें शामिल होने का न्योता दिया है. |
DISCOVERABLE |
स्पेस मैनेजर ने टारगेट ऑडियंस को स्पेस का ऐक्सेस दिया हो. जिन उपयोगकर्ताओं या Google Groups को स्पेस में अलग-अलग तौर पर जोड़ा गया है या शामिल होने का न्योता दिया गया है वे भी स्पेस को ढूंढ सकते हैं और उसे ऐक्सेस कर सकते हैं. ज़्यादा जानने के लिए, स्पेस को चुनिंदा उपयोगकर्ताओं के लिए उपलब्ध कराना लेख पढ़ें. संगठन के सभी सदस्यों के लिए स्पेस बनाने के लिए, उपयोगकर्ता की पुष्टि करना ज़रूरी है. |
AccessPermissionSettings
स्पेस को ऐक्सेस करने की अनुमतियों की सेटिंग.
| JSON के काेड में दिखाना |
|---|
{ "discoverSpaceSetting": { object ( |
| फ़ील्ड | |
|---|---|
discoverSpaceSetting |
ज़रूरी नहीं. स्पेस को खोजने के लिए, ऐक्सेस करने की अनुमति की सेटिंग. |
joinSpaceSetting |
ज़रूरी नहीं. स्पेस में शामिल होने के लिए, ऐक्सेस करने की अनुमति की सेटिंग. |
viewSpaceMembershipSetting |
ज़रूरी नहीं. स्पेस की सदस्यता देखने के लिए, ऐक्सेस करने की अनुमति से जुड़ी सेटिंग. स्पेस की सदस्यता कौन देख सकता है, यह अपडेट करते समय, अपडेट मास्क और अनुरोध के मुख्य हिस्से में |
AccessPermissionSetting
ऐक्सेस करने की अनुमति की सेटिंग.
| JSON के काेड में दिखाना |
|---|
{
"principals": [
{
object ( |
| फ़ील्ड | |
|---|---|
principals[] |
ज़रूरी नहीं. बिना क्रम वाली सूची. इस अनुमति के लिए, अनुमति वाले प्रिंसिपल. |
मुख्य रकम
ऐसी इकाई का प्रिंसिपल जिसे ऐक्सेस दिया गया है.
| JSON के काेड में दिखाना |
|---|
{
"audience": {
object ( |
| फ़ील्ड | |
|---|---|
| प्रिंसिपल का टाइप. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
audience |
ऑडियंस. |
| एक-दूसरे से अलग फ़ील्ड के आखिर में. | |
ऑडियंस
Google Chat में मौजूद कोई टारगेट ऑडियंस. टारगेट ऑडियंस, Google Workspace संगठन के उपयोगकर्ताओं का एक ग्रुप होता है. इसे एडमिन तय करता है. टारगेट ऑडियंस का इस्तेमाल, संसाधनों के लिए ऐक्सेस और डिवाइस या जानकारी दिखने की सेटिंग कॉन्फ़िगर करने के लिए किया जाता है. जैसे, किसी स्पेस को उपयोगकर्ताओं के किसी खास ग्रुप के लिए खोजे जाने लायक बनाना.
ज़्यादा जानकारी के लिए, टारगेट ऑडियंस और टारगेट ऑडियंस के लिए स्पेस को खोजने लायक बनाना लेख पढ़ें.
| JSON के काेड में दिखाना |
|---|
{ "name": string } |
| फ़ील्ड | |
|---|---|
name |
टारगेट ऑडियंस के संसाधन का नाम. यह वह ऑडियंस होती है जो स्पेस को खोज सकती है या उसमें शामिल हो सकती है. ज़्यादा जानकारी के लिए, किसी स्पेस को टारगेट ऑडियंस के लिए खोजे जाने लायक बनाना लेख पढ़ें. फ़ॉर्मैट: Google Workspace संगठन के लिए डिफ़ॉल्ट टारगेट ऑडियंस का इस्तेमाल करने के लिए, इसे |
PredefinedPermissionSettings
अनुमति से जुड़ी पहले से तय की गई सेटिंग. इन्हें सिर्फ़ नाम वाला स्पेस बनाते समय सेट किया जा सकता है. आने वाले समय में, इसमें और सेटिंग जोड़ी जा सकती हैं. नाम वाले स्पेस के लिए, अनुमति की सेटिंग के बारे में जानने के लिए, स्पेस के बारे में जानकारी लेख पढ़ें.
| Enums | |
|---|---|
PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED |
नहीं बताया गया है इसका इस्तेमाल न करें. |
COLLABORATION_SPACE |
इस सेटिंग की मदद से, स्पेस को ऐसा स्पेस बनाया जा सकता है जहां सभी सदस्य मैसेज पोस्ट कर सकें. |
ANNOUNCEMENT_SPACE |
इस सेटिंग की मदद से, स्पेस को सूचना ब्रॉडकास्ट करने वाले स्पेस के तौर पर सेट किया जा सकता है. इसमें सिर्फ़ स्पेस मैनेजर ही मैसेज पोस्ट कर सकते हैं. |
PermissionSettings
अनुमति की सेटिंग, जिन्हें नाम वाले मौजूदा स्पेस को अपडेट करते समय सेट किया जा सकता है.
स्पेस बनाते समय अनुमति की सेटिंग सेट करने के लिए, अपने अनुरोध में PredefinedPermissionSettings फ़ील्ड की जानकारी दें.
| JSON के काेड में दिखाना |
|---|
{ "manageMembersAndGroups": { object ( |
| फ़ील्ड | |
|---|---|
manageMembersAndGroups |
ज़रूरी नहीं. स्पेस में सदस्यों और ग्रुप को मैनेज करने की सेटिंग. |
modifySpaceDetails |
ज़रूरी नहीं. स्पेस का नाम, अवतार, ब्यौरा, और दिशा-निर्देश अपडेट करने की सेटिंग. |
toggleHistory |
ज़रूरी नहीं. स्पेस के इतिहास को टॉगल करके, चालू और बंद करने की सेटिंग. |
useAtMentionAll |
ज़रूरी नहीं. स्पेस में @all का इस्तेमाल करने की सेटिंग. |
manageApps |
ज़रूरी नहीं. स्पेस में ऐप्लिकेशन मैनेज करने की सेटिंग. |
manageWebhooks |
ज़रूरी नहीं. किसी स्पेस में वेबहुक मैनेज करने की सेटिंग. |
postMessages |
सिर्फ़ आउटपुट के लिए. स्पेस में मैसेज पोस्ट करने की सेटिंग. |
replyMessages |
ज़रूरी नहीं. स्पेस में मैसेज का जवाब देने की सेटिंग. |
viewSpaceMembership |
ज़रूरी नहीं. स्पेस की सदस्यता देखने की सेटिंग. स्पेस की सदस्यता कौन देख सकता है, यह अपडेट करते समय, अपडेट मास्क और अनुरोध के मुख्य हिस्से में |
PermissionSetting
यह स्पेस की अनुमति की सेटिंग को दिखाता है.
| JSON के काेड में दिखाना |
|---|
{ "managersAllowed": boolean, "membersAllowed": boolean, "assistantManagersAllowed": boolean } |
| फ़ील्ड | |
|---|---|
managersAllowed |
ज़रूरी नहीं. स्पेस के मालिकों ( |
membersAllowed |
ज़रूरी नहीं. क्या स्पेस के सामान्य सदस्यों ( |
assistantManagersAllowed |
ज़रूरी नहीं. स्पेस मैनेजर |
तरीके |
|
|---|---|
|
यह कुकी, तय किए गए स्पेस के लिए डेटा इंपोर्ट करने की प्रोसेस पूरी करती है. साथ ही, इसे उपयोगकर्ताओं के लिए उपलब्ध कराती है. |
|
इससे स्पेस बनाया जाता है. |
|
नाम वाले स्पेस को मिटाता है. |
|
यह फ़ंक्शन, तय किए गए उपयोगकर्ता के साथ मौजूदा डायरेक्ट मैसेज दिखाता है. |
|
यह फ़ंक्शन, spaceType == GROUP_CHAT वाले सभी स्पेस दिखाता है. इनमें ऐसे स्पेस शामिल हैं जिनमें सिर्फ़ कॉल करने वाला उपयोगकर्ता और FindGroupChatsRequest.users में बताए गए उपयोगकर्ता शामिल हैं. |
|
किसी स्पेस के बारे में जानकारी दिखाता है. |
|
इससे उन स्पेस की सूची मिलती है जिनमें कॉल करने वाला व्यक्ति सदस्य है. |
|
इस स्पेस को अपडेट करता है. |
|
यह Google Workspace संगठन में मौजूद स्पेस की सूची दिखाता है. |
|
यह स्पेस बनाता है और उसमें चुने गए उपयोगकर्ताओं को जोड़ता है. |