Package google.chat.v1

इंडेक्स

ChatService

इस कुकी की मदद से डेवलपर, Google Chat Platform पर Chat ऐप्लिकेशन और इंटिग्रेशन बना सकते हैं.

CompleteImportSpace

rpc CompleteImportSpace(CompleteImportSpaceRequest) returns (CompleteImportSpaceResponse)

यह नीति, चुने गए स्पेस के लिए डेटा इंपोर्ट करने की प्रोसेस पूरी करती है. साथ ही, इसे उपयोगकर्ताओं के लिए उपलब्ध कराती है.

इसके लिए, उपयोगकर्ता की पुष्टि और अनुमति के दायरे के साथ, पूरे डोमेन के लिए ऐक्सेस देने की सुविधा ज़रूरी है:

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

ज़्यादा जानकारी के लिए, Google Chat ऐप्लिकेशन को डेटा इंपोर्ट करने की अनुमति देना लेख पढ़ें.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

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

CreateCustomEmoji

rpc CreateCustomEmoji(CreateCustomEmojiRequest) returns (CustomEmoji)

इसकी मदद से कस्टम इमोजी बनाया जा सकता है.

पसंद के मुताबिक बनाए गए इमोजी सिर्फ़ Google Workspace खातों के लिए उपलब्ध हैं. साथ ही, एडमिन को संगठन के लिए, पसंद के मुताबिक बनाए गए इमोजी की सुविधा चालू करनी होगी. ज़्यादा जानकारी के लिए, Google Chat में पसंद के मुताबिक बनाए गए इमोजी के बारे में जानकारी और पसंद के मुताबिक बनाए गए इमोजी इस्तेमाल करने की अनुमतियां मैनेज करना लेख पढ़ें.

इसके लिए, अनुमति के दायरे के साथ उपयोगकर्ता की पुष्टि करना ज़रूरी है:

  • https://www.googleapis.com/auth/chat.customemojis
अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/chat.customemojis

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

CreateMembership

rpc CreateMembership(CreateMembershipRequest) returns (Membership)

यह Chat ऐप्लिकेशन, किसी उपयोगकर्ता या Google ग्रुप के लिए सदस्यता बनाता है. Chat के अन्य ऐप्लिकेशन के लिए सदस्यताएं नहीं बनाई जा सकतीं. सदस्यता बनाते समय, अगर चुने गए सदस्य ने अपने-आप न्योता स्वीकार करने की नीति बंद की हुई है, तो उसे न्योता भेजा जाता है. उसे स्पेस में शामिल होने से पहले, न्योता स्वीकार करना होगा. इसके अलावा, सदस्यता बनाने पर सदस्य को सीधे तौर पर चुने गए स्पेस में जोड़ दिया जाता है.

इन तरह के पुष्टि करने के तरीके काम करते हैं:

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

    • https://www.googleapis.com/auth/chat.app.memberships
  • उपयोगकर्ता की पुष्टि, अनुमति के इन स्कोप में से किसी एक के साथ:

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

ऐप्लिकेशन की पुष्टि करने की सुविधा, इस्तेमाल के इन उदाहरणों के लिए काम नहीं करती:

  • Workspace का इस्तेमाल करने वाले उस संगठन से बाहर के लोगों को न्योता भेजना जिसके पास स्पेस का मालिकाना हक है.
  • किसी स्पेस में Google ग्रुप जोड़ना.
  • किसी स्पेस में Chat ऐप्लिकेशन जोड़ना.

इस्तेमाल से जुड़े उदाहरण के लिए, यह लेख पढ़ें:

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.app.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.app

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

CreateMessage

rpc CreateMessage(CreateMessageRequest) returns (Message)

यह फ़ंक्शन, Google Chat स्पेस में कोई मैसेज बनाता है. उदाहरण के लिए, मैसेज भेजना देखें.

इन तरह के पुष्टि करने के तरीके काम करते हैं:

आपके अनुरोध में इस्तेमाल किए गए पुष्टि करने के तरीके के आधार पर, Chat मैसेज भेजने वाले व्यक्ति को अलग-अलग तरीके से एट्रिब्यूट करता है.

नीचे दी गई इमेज में दिखाया गया है कि ऐप्लिकेशन की पुष्टि करने की सुविधा का इस्तेमाल करने पर, Chat किसी मैसेज को कैसे एट्रिब्यूट करता है. Chat, मैसेज भेजने वाले के तौर पर Chat ऐप्लिकेशन को दिखाता है. मैसेज के कॉन्टेंट में टेक्स्ट (text), कार्ड (cardsV2), और ऐक्सेसरी विजेट (accessoryWidgets) शामिल हो सकते हैं.

ऐप्लिकेशन की पुष्टि करके मैसेज भेजा गया

नीचे दी गई इमेज में दिखाया गया है कि उपयोगकर्ता की पुष्टि करने की सुविधा का इस्तेमाल करने पर, Chat किसी मैसेज को कैसे एट्रिब्यूट करता है. Chat में, उपयोगकर्ता को मैसेज भेजने वाले के तौर पर दिखाया जाता है. साथ ही, Chat ऐप्लिकेशन का नाम दिखाकर, मैसेज का क्रेडिट उसे दिया जाता है. मैसेज के कॉन्टेंट में सिर्फ़ टेक्स्ट (text) शामिल किया जा सकता है.

उपयोगकर्ता की पुष्टि करके भेजा गया मैसेज

मैसेज का साइज़, मैसेज के कॉन्टेंट के साथ-साथ 32,000 बाइट से ज़्यादा नहीं होना चाहिए.

वेबहुक के अनुरोधों के लिए, जवाब में पूरा मैसेज शामिल नहीं होता. जवाब में, अनुरोध में दी गई जानकारी के साथ-साथ सिर्फ़ name और thread.name फ़ील्ड की जानकारी शामिल की गई है.

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.create

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

CreateMessagePin

rpc CreateMessagePin(CreateMessagePinRequest) returns (MessagePin)

मैसेज पिन करता है.

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

  • https://www.googleapis.com/auth/chat.spaces.pins
  • https://www.googleapis.com/auth/chat.spaces
अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

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

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

CreateReaction

rpc CreateReaction(CreateReactionRequest) returns (Reaction)

यह फ़ंक्शन, किसी मैसेज पर प्रतिक्रिया देता है और उसे मैसेज में जोड़ता है. उदाहरण के लिए, किसी मैसेज पर प्रतिक्रिया जोड़ना देखें.

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

  • https://www.googleapis.com/auth/chat.messages.reactions.create
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.import (सिर्फ़ इंपोर्ट मोड वाले स्पेस)
अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.create

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

CreateSection

rpc CreateSection(CreateSectionRequest) returns (Section)

Google Chat में सेक्शन बनाता है. सेक्शन की मदद से, उपयोगकर्ता बातचीत को ग्रुप कर सकते हैं. साथ ही, Chat के नेविगेशन पैनल में दिखने वाले स्पेस की सूची को पसंद के मुताबिक बना सकते हैं. सिर्फ़ CUSTOM_SECTION टाइप के सेक्शन बनाए जा सकते हैं. ज़्यादा जानकारी के लिए, Google Chat में सेक्शन बनाना और उन्हें व्यवस्थित करना लेख पढ़ें.

इसके लिए, अनुमति के दायरे के साथ उपयोगकर्ता की पुष्टि करना ज़रूरी है:

  • https://www.googleapis.com/auth/chat.users.sections
अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/chat.users.sections

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

CreateSpace

rpc CreateSpace(CreateSpaceRequest) returns (Space)

स्पेस बनाता है. इसका इस्तेमाल, Import mode में नाम वाला स्पेस या ग्रुप चैट बनाने के लिए किया जा सकता है. उदाहरण के लिए, स्पेस बनाना लेख पढ़ें.

इन तरह के पुष्टि करने के तरीके काम करते हैं:

  • ऐप्लिकेशन की पुष्टि के लिए, एडमिन की मंज़ूरी और यहां दिए गए किसी एक ऑथराइज़ेशन स्कोप का इस्तेमाल किया जाता है:

    • https://www.googleapis.com/auth/chat.app.spaces.create
    • https://www.googleapis.com/auth/chat.app.spaces
  • उपयोगकर्ता की पुष्टि, अनुमति के इन स्कोप में से किसी एक के साथ:

    • https://www.googleapis.com/auth/chat.spaces.create
    • https://www.googleapis.com/auth/chat.spaces
    • https://www.googleapis.com/auth/chat.import (सिर्फ़ इंपोर्ट मोड वाले स्पेस)

ऐप्लिकेशन के तौर पर पुष्टि करते समय, अनुरोध में space.customer फ़ील्ड सेट होना चाहिए.

ऐप्लिकेशन के तौर पर पुष्टि करने पर, Chat ऐप्लिकेशन को स्पेस के सदस्य के तौर पर जोड़ा जाता है. हालांकि, व्यक्ति के तौर पर पुष्टि करने के उलट, Chat ऐप्लिकेशन को स्पेस मैनेजर के तौर पर नहीं जोड़ा जाता. डिफ़ॉल्ट रूप से, स्पेस के सभी सदस्य Chat ऐप्लिकेशन को स्पेस से हटा सकते हैं. अगर आपको सिर्फ़ स्पेस मैनेजर को किसी स्पेस से ऐप्लिकेशन हटाने की अनुमति देनी है, तो space.permission_settings.manage_apps को managers_allowed पर सेट करें.

स्पेस बनाते समय, स्पेस की सदस्यता इस बात पर निर्भर करती है कि स्पेस को Import mode में बनाया गया है या नहीं:

  • इंपोर्ट मोड: इसमें कोई सदस्य नहीं बनाया जाता.
  • अन्य सभी मोड: कॉल करने वाले व्यक्ति को सदस्य के तौर पर जोड़ा जाता है. यह:
    • ऐप्लिकेशन की पुष्टि करने की सुविधा का इस्तेमाल करते समय, ऐप्लिकेशन खुद.
    • उपयोगकर्ता की पुष्टि करने की सुविधा का इस्तेमाल करते समय, असली उपयोगकर्ता.

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

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

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

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

DeleteCustomEmoji

rpc DeleteCustomEmoji(DeleteCustomEmojiRequest) returns (Empty)

यह कमांड, पसंद के मुताबिक बनाए गए इमोजी को मिटाती है. डिफ़ॉल्ट रूप से, उपयोगकर्ता सिर्फ़ उन इमोजी को मिटा सकते हैं जिन्हें उन्होंने बनाया है. एडमिन की ओर से असाइन किए गए इमोजी मैनेजर, संगठन में मौजूद किसी भी इमोजी को मिटा सकते हैं. Google Chat में पसंद के मुताबिक बनाए गए इमोजी के बारे में जानें लेख पढ़ें.

पसंद के मुताबिक बनाए गए इमोजी सिर्फ़ Google Workspace खातों के लिए उपलब्ध हैं. साथ ही, एडमिन को संगठन के लिए, पसंद के मुताबिक बनाए गए इमोजी की सुविधा चालू करनी होगी. ज़्यादा जानकारी के लिए, Google Chat में पसंद के मुताबिक बनाए गए इमोजी के बारे में जानकारी और पसंद के मुताबिक बनाए गए इमोजी इस्तेमाल करने की अनुमतियां मैनेज करना लेख पढ़ें.

इसके लिए, अनुमति के दायरे के साथ उपयोगकर्ता की पुष्टि करना ज़रूरी है:

  • https://www.googleapis.com/auth/chat.customemojis
अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/chat.customemojis

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

DeleteMembership

rpc DeleteMembership(DeleteMembershipRequest) returns (Membership)

यह सदस्यता मिटाता है. उदाहरण के लिए, किसी स्पेस से किसी उपयोगकर्ता या Google Chat ऐप्लिकेशन को हटाना देखें.

इन तरह के पुष्टि करने के तरीके काम करते हैं:

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

    • https://www.googleapis.com/auth/chat.app.memberships
  • उपयोगकर्ता की पुष्टि, अनुमति के इन स्कोप में से किसी एक के साथ:

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

ऐप्लिकेशन की पुष्टि करने की सुविधा, इस्तेमाल के इन उदाहरणों के लिए काम नहीं करती:

  • किसी स्पेस से Google ग्रुप को हटाना.
  • किसी स्पेस से Chat ऐप्लिकेशन को हटाना.

स्पेस मैनेजर की सदस्यताएं मिटाने के लिए, अनुरोध करने वाले व्यक्ति के पास स्पेस मैनेजर की भूमिका होनी चाहिए. अगर ऐप्लिकेशन की पुष्टि करने की सुविधा का इस्तेमाल किया जा रहा है, तो Chat ऐप्लिकेशन को स्पेस बनाने वाला ऐप्लिकेशन होना चाहिए.

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.app.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.app

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

DeleteMessage

rpc DeleteMessage(DeleteMessageRequest) returns (Empty)

यह कुकी, मैसेज को मिटाती है. उदाहरण के लिए, मैसेज मिटाना लेख पढ़ें.

इन तरह के पुष्टि करने के तरीके काम करते हैं:

ऐप्लिकेशन की पुष्टि करने की सुविधा का इस्तेमाल करने पर, अनुरोध सिर्फ़ उस Chat ऐप्लिकेशन से बनाए गए मैसेज मिटा सकते हैं जिससे कॉल किया गया है.

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages

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

DeleteMessagePin

rpc DeleteMessagePin(DeleteMessagePinRequest) returns (Empty)

यह मैसेज पिन करने की सुविधा को बंद करता है.

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

  • https://www.googleapis.com/auth/chat.spaces.pins
  • https://www.googleapis.com/auth/chat.spaces
अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

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

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

DeleteReaction

rpc DeleteReaction(DeleteReactionRequest) returns (Empty)

यह किसी मैसेज पर दी गई प्रतिक्रिया को मिटाता है. उदाहरण के लिए, प्रतिक्रिया मिटाना देखें.

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

  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.import (सिर्फ़ इंपोर्ट मोड वाले स्पेस)
अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.reactions

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

DeleteSection

rpc DeleteSection(DeleteSectionRequest) returns (Empty)

यह CUSTOM_SECTION टाइप के सेक्शन को मिटाता है.

अगर सेक्शन में स्पेस जैसे आइटम मौजूद हैं, तो उन्हें Google Chat के डिफ़ॉल्ट सेक्शन में ले जाया जाता है. हालांकि, उन्हें मिटाया नहीं जाता.

ज़्यादा जानकारी के लिए, Google Chat में सेक्शन बनाना और उन्हें व्यवस्थित करना लेख पढ़ें.

इसके लिए, अनुमति के दायरे के साथ उपयोगकर्ता की पुष्टि करना ज़रूरी है:

  • https://www.googleapis.com/auth/chat.users.sections
अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/chat.users.sections

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

DeleteSpace

rpc DeleteSpace(DeleteSpaceRequest) returns (Empty)

नाम वाले स्पेस को मिटाता है. यह हमेशा कैस्केडिंग डिलीट करता है. इसका मतलब है कि स्पेस के चाइल्ड रिसॉर्स भी मिट जाते हैं. जैसे, स्पेस में पोस्ट किए गए मैसेज और स्पेस में मौजूद सदस्यताएं. उदाहरण के लिए, स्पेस मिटाना देखें.

इन तरह के पुष्टि करने के तरीके काम करते हैं:

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

    • https://www.googleapis.com/auth/chat.app.delete (सिर्फ़ उन स्पेस में जिन्हें ऐप्लिकेशन ने बनाया है)
  • उपयोगकर्ता की पुष्टि, अनुमति के इन स्कोप में से किसी एक के साथ:

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

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.app.delete
  • https://www.googleapis.com/auth/chat.admin.delete
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.delete

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

FindDirectMessage

rpc FindDirectMessage(FindDirectMessageRequest) returns (Space)

यह फ़ंक्शन, तय किए गए उपयोगकर्ता के साथ हुई मौजूदा बातचीत का डायरेक्ट मैसेज दिखाता है. अगर कोई डायरेक्ट मैसेज स्पेस नहीं मिलता है, तो यह 404 NOT_FOUND गड़बड़ी दिखाता है. उदाहरण के लिए, डायरेक्ट मैसेज ढूंढना देखें.

ऐप्लिकेशन की पुष्टि करने की सुविधा की मदद से, यह तरीका उस उपयोगकर्ता और कॉल करने वाले Chat ऐप्लिकेशन के बीच डायरेक्ट मैसेज स्पेस दिखाता है.

उपयोगकर्ता की पुष्टि करने की सुविधा की मदद से, यह फ़ंक्शन पुष्टि किए गए उपयोगकर्ता और बताए गए उपयोगकर्ता के बीच डायरेक्ट मैसेज स्पेस दिखाता है.

इन तरह के पुष्टि करने के तरीके काम करते हैं:

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.bot

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

FindGroupChats

rpc FindGroupChats(FindGroupChatsRequest) returns (FindGroupChatsResponse)

spaceType == GROUP_CHAT वाले सभी स्पेस दिखाता है. इनमें ऐसे स्पेस शामिल हैं जिनमें कॉल करने वाला उपयोगकर्ता और FindGroupChatsRequest.users में बताए गए उपयोगकर्ता शामिल हैं. सिर्फ़ वे सदस्य शामिल किए जाते हैं जो बातचीत में शामिल हुए हैं. उदाहरण के लिए, ग्रुप चैट ढूंढना देखें.

अगर कॉल करने वाला उपयोगकर्ता, कुछ उपयोगकर्ताओं को ब्लॉक करता है या उसे कुछ उपयोगकर्ताओं ने ब्लॉक किया है और उपयोगकर्ताओं के पूरे सेट के साथ कोई स्पेस नहीं मिलता है, तो यह तरीका ऐसे स्पेस दिखाता है जिनमें ब्लॉक किए गए या ब्लॉक करने वाले उपयोगकर्ता शामिल नहीं होते हैं.

उपयोगकर्ताओं के तय किए गए सेट में, सिर्फ़ इंसानों (ऐप्लिकेशन के अलावा) की सदस्यताएं होनी चाहिए. अगर किसी अनुरोध में इंसानों के अलावा अन्य उपयोगकर्ताओं को शामिल किया जाता है, तो कोई भी स्पेस नहीं दिखता.

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

  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/chat.memberships
अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly

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

GetAttachment

rpc GetAttachment(GetAttachmentRequest) returns (Attachment)

यह किसी मैसेज अटैचमेंट का मेटाडेटा पाता है. अटैचमेंट डेटा को मीडिया एपीआई का इस्तेमाल करके फ़ेच किया जाता है. उदाहरण के लिए, किसी मैसेज अटैचमेंट के बारे में मेटाडेटा पाना देखें.

इसके लिए, अनुमति के दायरे के साथ ऐप्लिकेशन की पुष्टि करना ज़रूरी है:

  • https://www.googleapis.com/auth/chat.bot
अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/chat.bot

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

GetCustomEmoji

rpc GetCustomEmoji(GetCustomEmojiRequest) returns (CustomEmoji)

यह फ़ंक्शन, पसंद के मुताबिक बनाए गए इमोजी के बारे में जानकारी दिखाता है.

पसंद के मुताबिक बनाए गए इमोजी सिर्फ़ Google Workspace खातों के लिए उपलब्ध हैं. साथ ही, एडमिन को संगठन के लिए, पसंद के मुताबिक बनाए गए इमोजी की सुविधा चालू करनी होगी. ज़्यादा जानकारी के लिए, Google Chat में पसंद के मुताबिक बनाए गए इमोजी के बारे में जानकारी और पसंद के मुताबिक बनाए गए इमोजी इस्तेमाल करने की अनुमतियां मैनेज करना लेख पढ़ें.

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

  • https://www.googleapis.com/auth/chat.customemojis.readonly
  • https://www.googleapis.com/auth/chat.customemojis
अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.customemojis
  • https://www.googleapis.com/auth/chat.customemojis.readonly

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

GetMembership

rpc GetMembership(GetMembershipRequest) returns (Membership)

सदस्यता के बारे में जानकारी दिखाता है. उदाहरण के लिए, किसी उपयोगकर्ता या Google Chat ऐप्लिकेशन की सदस्यता के बारे में जानकारी पाना देखें.

इन तरह के पुष्टि करने के तरीके काम करते हैं:

  • ऐप्लिकेशन की पुष्टि, अनुमति के इन स्कोप में से किसी एक के साथ की गई हो:

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

    • https://www.googleapis.com/auth/chat.memberships.readonly
    • https://www.googleapis.com/auth/chat.memberships
    • उपयोगकर्ता की पुष्टि करने पर, एडमिन को एडमिन के अधिकार मिलते हैं. ऐसा तब होता है, जब एडमिन खाता पुष्टि करता है, use_admin_access true होता है, और इनमें से किसी एक अनुमति के दायरे का इस्तेमाल किया जाता है:
      • https://www.googleapis.com/auth/chat.admin.memberships.readonly
      • https://www.googleapis.com/auth/chat.admin.memberships
अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships.readonly
  • https://www.googleapis.com/auth/chat.app.memberships
  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly

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

GetMessage

rpc GetMessage(GetMessageRequest) returns (Message)

यह फ़ंक्शन, किसी मैसेज के बारे में जानकारी दिखाता है. उदाहरण के लिए, किसी मैसेज के बारे में जानकारी पाना देखें.

इन तरह के पुष्टि करने के तरीके काम करते हैं:

  • ऐप्लिकेशन की पुष्टि, अनुमति के इन स्कोप में से किसी एक के साथ की गई हो:

    • https://www.googleapis.com/auth/chat.bot: अनुमति के इस स्कोप का इस्तेमाल करने पर, यह तरीका उस मैसेज के बारे में जानकारी दिखाता है जिसे Chat ऐप्लिकेशन ऐक्सेस कर सकता है. जैसे, डायरेक्ट मैसेज और Chat ऐप्लिकेशन को चालू करने वाली स्लैश कमांड.
    • https://www.googleapis.com/auth/chat.app.messages.readonly के लिए एडमिन की मंज़ूरी ज़रूरी है. पुष्टि करने के इस स्कोप का इस्तेमाल करने पर, यह तरीका किसी स्पेस में मौजूद सार्वजनिक मैसेज के बारे में जानकारी दिखाता है.
  • उपयोगकर्ता की पुष्टि, अनुमति के इन स्कोप में से किसी एक के साथ:

    • https://www.googleapis.com/auth/chat.messages.readonly
    • https://www.googleapis.com/auth/chat.messages

ध्यान दें: ऐसा हो सकता है कि ब्लॉक किए गए किसी सदस्य या स्पेस से मिला मैसेज वापस आ जाए.

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.app.messages.readonly

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

GetSpace

rpc GetSpace(GetSpaceRequest) returns (Space)

यह स्पेस के बारे में जानकारी दिखाता है. उदाहरण के लिए, किसी स्पेस के बारे में जानकारी पाना देखें.

इन तरह के पुष्टि करने के तरीके काम करते हैं:

  • ऐप्लिकेशन की पुष्टि, अनुमति के इन स्कोप में से किसी एक के साथ की गई हो:

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

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

ऐप्लिकेशन की पुष्टि करने की सुविधा पर ये सीमाएं लागू होती हैं:

  • chat.app.spaces स्कोप का इस्तेमाल करने पर ही, space.access_settings फ़ील्ड में वैल्यू भरी जाती है.
  • space.predefind_permission_settings और space.permission_settings फ़ील्ड में वैल्यू सिर्फ़ तब दिखती हैं, जब chat.app.spaces स्कोप का इस्तेमाल किया जा रहा हो. साथ ही, ये वैल्यू सिर्फ़ उन स्पेस के लिए दिखती हैं जिन्हें ऐप्लिकेशन ने बनाया है.
अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

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

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

GetSpaceEvent

rpc GetSpaceEvent(GetSpaceEventRequest) returns (SpaceEvent)

यह फ़ंक्शन, Google Chat स्पेस से कोई इवेंट दिखाता है. इवेंट पेलोड में, बदली गई रिसॉर्स का सबसे नया वर्शन होता है. उदाहरण के लिए, अगर आपने किसी नए मैसेज के बारे में इवेंट का अनुरोध किया है, लेकिन बाद में मैसेज को अपडेट कर दिया गया है, तो सर्वर, इवेंट पेलोड में अपडेट की गई Message रिसॉर्स दिखाता है.

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

यह अनुरोध किए गए डेटा को पढ़ने के लिए, सही अनुमति के दायरे के साथ, पुष्टि करने के इन तरीकों के साथ काम करता है:

  • ऐप्लिकेशन की पुष्टि के लिए, एडमिन की मंज़ूरी ज़रूरी है. इसके लिए, इनमें से किसी एक ऑथराइज़ेशन स्कोप का इस्तेमाल किया जाता है:

    • https://www.googleapis.com/auth/chat.app.spaces
    • https://www.googleapis.com/auth/chat.app.spaces.readonly
    • https://www.googleapis.com/auth/chat.app.messages.readonly
    • https://www.googleapis.com/auth/chat.app.memberships
    • https://www.googleapis.com/auth/chat.app.memberships.readonly
  • उपयोगकर्ता की पुष्टि, अनुमति के इन स्कोप में से किसी एक के साथ:

    • https://www.googleapis.com/auth/chat.spaces.readonly
    • https://www.googleapis.com/auth/chat.spaces
    • https://www.googleapis.com/auth/chat.messages.readonly
    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.messages.reactions.readonly
    • https://www.googleapis.com/auth/chat.messages.reactions
    • https://www.googleapis.com/auth/chat.memberships.readonly
    • https://www.googleapis.com/auth/chat.memberships

किसी इवेंट को पाने के लिए, पुष्टि किए गए कॉलर का स्पेस का सदस्य होना ज़रूरी है.

उदाहरण के लिए, Google Chat स्पेस से किसी इवेंट के बारे में जानकारी पाना लेख पढ़ें.

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.app.memberships
  • https://www.googleapis.com/auth/chat.app.memberships.readonly
  • https://www.googleapis.com/auth/chat.app.messages.readonly
  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/chat.app.spaces.readonly
  • https://www.googleapis.com/auth/chat.app.all.messages.readonly
  • https://www.googleapis.com/auth/chat.app.all.spaces.readonly
  • https://www.googleapis.com/auth/chat.app.all.memberships.readonly
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly

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

GetSpaceNotificationSetting

rpc GetSpaceNotificationSetting(GetSpaceNotificationSettingRequest) returns (SpaceNotificationSetting)

स्पेस की सूचना सेटिंग मिलती है. उदाहरण के लिए, कॉल करने वाले व्यक्ति के स्पेस की सूचना सेटिंग पाना देखें.

इसके लिए, अनुमति के दायरे के साथ उपयोगकर्ता की पुष्टि करना ज़रूरी है:

  • https://www.googleapis.com/auth/chat.users.spacesettings
अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/chat.users.spacesettings

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

GetSpaceReadState

rpc GetSpaceReadState(GetSpaceReadStateRequest) returns (SpaceReadState)

यह फ़ंक्शन, किसी स्पेस में उपयोगकर्ता के मैसेज पढ़े जाने की स्थिति के बारे में जानकारी देता है. इसका इस्तेमाल, पढ़े गए और न पढ़े गए मैसेज की पहचान करने के लिए किया जाता है. उदाहरण के लिए, किसी स्पेस में उपयोगकर्ता के मैसेज पढ़े जाने की स्थिति के बारे में जानकारी पाना देखें.

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

  • https://www.googleapis.com/auth/chat.users.readstate.readonly
  • https://www.googleapis.com/auth/chat.users.readstate
अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.users.readstate
  • https://www.googleapis.com/auth/chat.users.readstate.readonly

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

GetThreadReadState

rpc GetThreadReadState(GetThreadReadStateRequest) returns (ThreadReadState)

यह फ़ंक्शन, किसी थ्रेड में उपयोगकर्ता के पढ़े गए मैसेज की स्थिति के बारे में जानकारी देता है. इसका इस्तेमाल, पढ़े गए और नहीं पढ़े गए मैसेज की पहचान करने के लिए किया जाता है. उदाहरण के लिए, किसी उपयोगकर्ता के थ्रेड को पढ़े जाने की स्थिति के बारे में जानकारी पाना देखें.

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

  • https://www.googleapis.com/auth/chat.users.readstate.readonly
  • https://www.googleapis.com/auth/chat.users.readstate
अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.users.readstate
  • https://www.googleapis.com/auth/chat.users.readstate.readonly

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

ListCustomEmojis

rpc ListCustomEmojis(ListCustomEmojisRequest) returns (ListCustomEmojisResponse)

यह कुकी, पुष्टि किए गए उपयोगकर्ता को दिखने वाले कस्टम इमोजी की सूची बनाती है.

पसंद के मुताबिक बनाए गए इमोजी सिर्फ़ Google Workspace खातों के लिए उपलब्ध हैं. साथ ही, एडमिन को संगठन के लिए, पसंद के मुताबिक बनाए गए इमोजी की सुविधा चालू करनी होगी. ज़्यादा जानकारी के लिए, Google Chat में पसंद के मुताबिक बनाए गए इमोजी के बारे में जानकारी और पसंद के मुताबिक बनाए गए इमोजी इस्तेमाल करने की अनुमतियां मैनेज करना लेख पढ़ें.

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

  • https://www.googleapis.com/auth/chat.customemojis.readonly
  • https://www.googleapis.com/auth/chat.customemojis
अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.customemojis
  • https://www.googleapis.com/auth/chat.customemojis.readonly

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

ListMemberships

rpc ListMemberships(ListMembershipsRequest) returns (ListMembershipsResponse)

किसी स्पेस में मौजूद सदस्यताओं की सूची बनाता है. उदाहरण के लिए, किसी स्पेस में मौजूद उपयोगकर्ताओं और Google Chat ऐप्लिकेशन की सूची बनाना देखें. ऐप्लिकेशन की पुष्टि करके सदस्यताओं की सूची बनाने पर, उन स्पेस में मौजूद सदस्यताओं की सूची बनती है जिन्हें Chat ऐप्लिकेशन ऐक्सेस कर सकता है. हालांकि, इसमें Chat ऐप्लिकेशन की सदस्यताएं शामिल नहीं होती हैं. इसमें खुद की सदस्यता भी शामिल नहीं होती. उपयोगकर्ता की पुष्टि करके सदस्यताओं की सूची बनाने पर, उन स्पेस में मौजूद सदस्यताओं की सूची बनती है जिन्हें पुष्टि किया गया उपयोगकर्ता ऐक्सेस कर सकता है.

इन तरह के पुष्टि करने के तरीके काम करते हैं:

  • ऐप्लिकेशन की पुष्टि, अनुमति के इन स्कोप में से किसी एक के साथ की गई हो:

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

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

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships.readonly
  • https://www.googleapis.com/auth/chat.app.memberships
  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly

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

ListMessagePins

rpc ListMessagePins(ListMessagePinsRequest) returns (ListMessagePinsResponse)

किसी स्पेस में पिन किए गए मैसेज की सूची दिखाता है. उपयोगकर्ता, स्पेस में मौजूद ज़रूरी मैसेज को पिन कर सकते हैं, ताकि उन्हें आसानी से ऐक्सेस किया जा सके. ज़्यादा जानकारी के लिए, Google Chat में किसी बातचीत को पिन या अनपिन करना लेख पढ़ें.

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

  • https://www.googleapis.com/auth/chat.spaces.pins.readonly
  • https://www.googleapis.com/auth/chat.spaces.pins
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.spaces
अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.spaces.pins
  • https://www.googleapis.com/auth/chat.spaces.pins.readonly
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly

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

ListMessages

rpc ListMessages(ListMessagesRequest) returns (ListMessagesResponse)

इस स्पेस में मौजूद मैसेज की सूची दिखाता है. इसमें ब्लॉक किए गए सदस्यों और स्पेस के मैसेज भी शामिल होते हैं. इसमें सिस्टम मैसेज शामिल नहीं होते. जैसे, नए स्पेस सदस्यों के बारे में सूचना देने वाले मैसेज. अगर आपने किसी ऐसे स्पेस के मैसेज की सूची बनाई है जिसमें कोई मैसेज नहीं है, तो जवाब एक खाली ऑब्जेक्ट होगा. REST/HTTP इंटरफ़ेस का इस्तेमाल करने पर, रिस्पॉन्स में एक खाली JSON ऑब्जेक्ट, {} शामिल होता है. उदाहरण के लिए, मैसेज की सूची देखें.

इन तरह के पुष्टि करने के तरीके काम करते हैं:

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

    • https://www.googleapis.com/auth/chat.app.messages.readonly. पुष्टि के इस स्कोप का इस्तेमाल करने पर, यह तरीका सिर्फ़ किसी स्पेस में मौजूद सार्वजनिक मैसेज दिखाता है. इसमें निजी मैसेज शामिल नहीं होते.
  • उपयोगकर्ता की पुष्टि, अनुमति के इन स्कोप में से किसी एक के साथ:

    • https://www.googleapis.com/auth/chat.messages.readonly
    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.import (सिर्फ़ इंपोर्ट मोड वाले स्पेस)
अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.app.messages.readonly

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

ListReactions

rpc ListReactions(ListReactionsRequest) returns (ListReactionsResponse)

किसी मैसेज पर दी गई प्रतिक्रियाओं की सूची दिखाता है. उदाहरण के लिए, किसी मैसेज पर दी गई प्रतिक्रियाओं की सूची देखें.

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

  • https://www.googleapis.com/auth/chat.messages.reactions.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.messages
अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly

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

ListSectionItems

rpc ListSectionItems(ListSectionItemsRequest) returns (ListSectionItemsResponse)

किसी सेक्शन में मौजूद आइटम की सूची दिखाता है.

सिर्फ़ स्पेस को सेक्शन आइटम के तौर पर इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, Google Chat में सेक्शन बनाना और उन्हें व्यवस्थित करना लेख पढ़ें.

इसके लिए, अनुमति के दायरे के साथ उपयोगकर्ता की पुष्टि करना ज़रूरी है:

  • https://www.googleapis.com/auth/chat.users.sections
  • https://www.googleapis.com/auth/chat.users.sections.readonly
अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.users.sections
  • https://www.googleapis.com/auth/chat.users.sections.readonly

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

ListSections

rpc ListSections(ListSectionsRequest) returns (ListSectionsResponse)

Chat उपयोगकर्ता के लिए उपलब्ध सेक्शन की सूची बनाता है. सेक्शन की मदद से, उपयोगकर्ता अपनी बातचीत को ग्रुप कर सकते हैं. साथ ही, Chat के नेविगेशन पैनल में दिखने वाले स्पेस की सूची को पसंद के मुताबिक बना सकते हैं. ज़्यादा जानकारी के लिए, Google Chat में सेक्शन बनाना और उन्हें व्यवस्थित करना लेख पढ़ें.

इसके लिए, अनुमति के दायरे के साथ उपयोगकर्ता की पुष्टि करना ज़रूरी है:

  • https://www.googleapis.com/auth/chat.users.sections
  • https://www.googleapis.com/auth/chat.users.sections.readonly
अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.users.sections
  • https://www.googleapis.com/auth/chat.users.sections.readonly

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

ListSpaceEvents

rpc ListSpaceEvents(ListSpaceEventsRequest) returns (ListSpaceEventsResponse)

Google Chat स्पेस के इवेंट की सूची बनाता है. हर इवेंट के लिए, payload में Chat संसाधन का सबसे नया वर्शन होता है. उदाहरण के लिए, अगर आपने नए स्पेस सदस्यों के बारे में इवेंट की सूची बनाई है, तो सर्वर Membership संसाधन दिखाता है. इनमें सदस्यता की नई जानकारी होती है. अगर अनुरोध की गई अवधि के दौरान नए सदस्यों को हटाया गया था, तो इवेंट पेलोड में एक खाली Membership संसाधन होता है.

यह अनुरोध किए गए डेटा को पढ़ने के लिए, सही अनुमति के दायरे के साथ, पुष्टि करने के इन तरीकों के साथ काम करता है:

  • ऐप्लिकेशन की पुष्टि के लिए, एडमिन की मंज़ूरी ज़रूरी है. इसके लिए, इनमें से किसी एक ऑथराइज़ेशन स्कोप का इस्तेमाल किया जाता है:

    • https://www.googleapis.com/auth/chat.app.spaces
    • https://www.googleapis.com/auth/chat.app.spaces.readonly
    • https://www.googleapis.com/auth/chat.app.messages.readonly
    • https://www.googleapis.com/auth/chat.app.memberships
    • https://www.googleapis.com/auth/chat.app.memberships.readonly
  • उपयोगकर्ता की पुष्टि, अनुमति के इन स्कोप में से किसी एक के साथ:

    • https://www.googleapis.com/auth/chat.spaces.readonly
    • https://www.googleapis.com/auth/chat.spaces
    • https://www.googleapis.com/auth/chat.messages.readonly
    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.messages.reactions.readonly
    • https://www.googleapis.com/auth/chat.messages.reactions
    • https://www.googleapis.com/auth/chat.memberships.readonly
    • https://www.googleapis.com/auth/chat.memberships

इवेंट की सूची बनाने के लिए, पुष्टि किए गए कॉलर का स्पेस का सदस्य होना ज़रूरी है.

उदाहरण के लिए, Google Chat स्पेस से इवेंट की सूची बनाना देखें.

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.app.memberships
  • https://www.googleapis.com/auth/chat.app.memberships.readonly
  • https://www.googleapis.com/auth/chat.app.messages.readonly
  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/chat.app.spaces.readonly
  • https://www.googleapis.com/auth/chat.app.all.messages.readonly
  • https://www.googleapis.com/auth/chat.app.all.spaces.readonly
  • https://www.googleapis.com/auth/chat.app.all.memberships.readonly
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly

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

ListSpaces

rpc ListSpaces(ListSpacesRequest) returns (ListSpacesResponse)

इससे उन स्पेस की सूची मिलती है जिनमें कॉल करने वाला व्यक्ति सदस्य है. जब तक पहला मैसेज नहीं भेजा जाता, तब तक ग्रुप चैट और डीएम की सूची नहीं दिखती. उदाहरण के लिए, स्पेस की सूची बनाएं देखें.

इन तरह के पुष्टि करने के तरीके काम करते हैं:

Google Workspace संगठन के हिसाब से, नाम वाले सभी स्पेस की सूची बनाने के लिए, Workspace एडमिन के तौर पर मिले अधिकारों का इस्तेमाल करके, spaces.search() तरीके का इस्तेमाल करें.

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.bot

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

MoveSectionItem

rpc MoveSectionItem(MoveSectionItemRequest) returns (MoveSectionItemResponse)

किसी आइटम को एक सेक्शन से दूसरे सेक्शन में ले जाता है. उदाहरण के लिए, अगर किसी सेक्शन में स्पेस मौजूद हैं, तो इस तरीके का इस्तेमाल करके किसी स्पेस को दूसरे सेक्शन में ले जाया जा सकता है. ज़्यादा जानकारी के लिए, Google Chat में सेक्शन बनाना और उन्हें व्यवस्थित करना लेख पढ़ें.

इसके लिए, अनुमति के दायरे के साथ उपयोगकर्ता की पुष्टि करना ज़रूरी है:

  • https://www.googleapis.com/auth/chat.users.sections
अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/chat.users.sections

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

PositionSection

rpc PositionSection(PositionSectionRequest) returns (PositionSectionResponse)

इससे किसी सेक्शन के क्रम में बदलाव होता है. ज़्यादा जानकारी के लिए, Google Chat में सेक्शन बनाना और उन्हें व्यवस्थित करना लेख पढ़ें.

इसके लिए, अनुमति के दायरे के साथ उपयोगकर्ता की पुष्टि करना ज़रूरी है:

  • https://www.googleapis.com/auth/chat.users.sections
अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/chat.users.sections

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

ReplaceMessageCards

rpc ReplaceMessageCards(ReplaceMessageCardsRequest) returns (ReplaceMessageCardsResponse)

यह सुविधा, मैसेज में शामिल कार्ड की जगह दिखती है.

Chat ऐप्लिकेशन, किसी व्यक्ति के बनाए गए मैसेज में मौजूद कार्ड को सिर्फ़ तब बदल सकता है, जब मैसेज में पहले से ही कार्ड मौजूद हों और उन्हें ऐप्लिकेशन ने बनाया हो.

अगर ऐप्लिकेशन, कार्ड को खाली सूची से बदल देता है, तो कार्ड हटा दिए जाते हैं. कार्ड हटाने के बाद, ऐप्लिकेशन मैसेज में कार्ड वापस नहीं जोड़ सकता.

इसके लिए, अनुमति के दायरे के साथ ऐप्लिकेशन की पुष्टि करना ज़रूरी है: - https://www.googleapis.com/auth/chat.bot

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/chat.bot

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

SearchMessages

rpc SearchMessages(SearchMessagesRequest) returns (SearchMessagesResponse)

यह सुविधा, कॉल करने वाले व्यक्ति के पास मौजूद Google Chat के मैसेज खोजती है. यह खोज के लिए तय की गई शर्तों से मेल खाने वाले मैसेज की सूची दिखाती है.

उपयोगकर्ता के पास जिन स्पेस का ऐक्सेस है उनमें खोजने के लिए, parent को spaces/- पर सेट करें. parent के लिए किसी अन्य वैल्यू का इस्तेमाल करने पर, INVALID_ARGUMENT गड़बड़ी होती है. जवाब में मिले मैसेज के name फ़ील्ड में, संसाधन का पूरा नाम होता है. इसमें वह space भी शामिल होता है जिसमें मैसेज मौजूद है.

यह एपीआई, सभी तरह के मैसेज नहीं दिखाता. यहां दिए गए मैसेज के टाइप, जवाब में शामिल नहीं किए जाते. सभी मैसेज की सूची बनाने के लिए, ListMessages का इस्तेमाल करें.

  • ऐसे निजी मैसेज जो पुष्टि किए गए उपयोगकर्ता को दिखते हैं.
  • स्पेस या ग्रुप चैट में Chat ऐप्लिकेशन से पोस्ट किए गए मैसेज.
  • Chat ऐप्लिकेशन के डीएम में मौजूद मैसेज.
  • ब्लॉक किए गए उपयोगकर्ताओं के मैसेज.
  • उन स्पेस में मौजूद मैसेज जिन्हें कॉल करने वाले व्यक्ति ने म्यूट किया है.

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

  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.messages
अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly

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

SearchSpaces

rpc SearchSpaces(SearchSpacesRequest) returns (SearchSpacesResponse)

यह फ़ंक्शन, एडमिन की खोज के आधार पर Google Workspace संगठन में मौजूद स्पेस की सूची दिखाता है. अनुरोध में, use_admin_access को true पर सेट करें. उदाहरण के लिए, स्पेस खोजना और उन्हें मैनेज करना लेख पढ़ें.

इसके लिए, एडमिन के अधिकारों के साथ उपयोगकर्ता की पुष्टि और इनमें से किसी एक अनुमति के दायरे की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.admin.spaces.readonly
  • https://www.googleapis.com/auth/chat.admin.spaces
अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.admin.spaces
  • https://www.googleapis.com/auth/chat.admin.spaces.readonly

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

SetUpSpace

rpc SetUpSpace(SetUpSpaceRequest) returns (Space)

यह स्पेस बनाता है और उसमें चुने गए उपयोगकर्ताओं को जोड़ता है. कॉल करने वाला उपयोगकर्ता, स्पेस में अपने-आप जुड़ जाता है. इसलिए, अनुरोध में उसे सदस्य के तौर पर नहीं बताया जाना चाहिए. उदाहरण के लिए, शुरुआती सदस्यों के साथ स्पेस सेट अप करना लेख पढ़ें.

जोड़ने के लिए, सदस्यों की जानकारी देने के लिए सही membership.member.name के साथ सदस्यताएं जोड़ें. किसी व्यक्ति को जोड़ने के लिए, users/{user} का इस्तेमाल करें. यहां {user}, व्यक्ति का ईमेल पता हो सकता है. एक ही Workspace संगठन के उपयोगकर्ताओं के लिए, {user}, People API में मौजूद व्यक्ति का id या Directory API में मौजूद उपयोगकर्ता का id भी हो सकता है. उदाहरण के लिए, अगर user@example.com के लिए People API का व्यक्ति प्रोफ़ाइल आईडी 123456789 है, तो membership.member.name को users/user@example.com या users/123456789 पर सेट करके, उपयोगकर्ता को स्पेस में जोड़ा जा सकता है.

जोड़ने के लिए Google ग्रुप तय करने के लिए, सही membership.group_member.name के साथ सदस्यताएं जोड़ें. किसी Google ग्रुप को जोड़ने या उसे न्योता भेजने के लिए, groups/{group} का इस्तेमाल करें. यहां {group}, Cloud Identity Groups API से मिले ग्रुप के लिए id है. उदाहरण के लिए, ग्रुप का ईमेल पता group@example.com के लिए आईडी 123456789 को वापस पाने के लिए, Cloud Identity Groups lookup API का इस्तेमाल किया जा सकता है. इसके बाद, membership.group_member.name को groups/123456789 पर सेट करके, ग्रुप को स्पेस में जोड़ा जा सकता है. ग्रुप का ईमेल पता मौजूद नहीं है. साथ ही, Google ग्रुप को सिर्फ़ नाम वाले स्पेस में सदस्यों के तौर पर जोड़ा जा सकता है.

अगर किसी स्पेस या ग्रुप चैट में कॉल करने वाला व्यक्ति, कुछ सदस्यों को ब्लॉक करता है या कुछ सदस्यों ने उसे ब्लॉक किया है या उसके पास कुछ सदस्यों को जोड़ने की अनुमति नहीं है, तो उन सदस्यों को बनाए गए स्पेस में नहीं जोड़ा जाता.

कॉल करने वाले व्यक्ति और किसी दूसरे व्यक्ति के बीच डायरेक्ट मैसेज (डीएम) बनाने के लिए, उस व्यक्ति की सदस्यता की जानकारी दें. अगर कोई व्यक्ति किसी दूसरे व्यक्ति को ब्लॉक करता है, तो अनुरोध पूरा नहीं होगा और डीएम नहीं बनाया जाएगा.

कॉल करने वाले व्यक्ति और कॉल करने वाले ऐप्लिकेशन के बीच डीएम बनाने के लिए, Space.singleUserBotDm को true पर सेट करें. साथ ही, कोई भी सदस्यता तय न करें. इस तरीके का इस्तेमाल सिर्फ़ कॉलिंग ऐप्लिकेशन के साथ डीएम सेट अप करने के लिए किया जा सकता है. कॉलिंग ऐप्लिकेशन को किसी स्पेस या दो लोगों के बीच मौजूद डीएम में सदस्य के तौर पर जोड़ने के लिए, किसी स्पेस में किसी उपयोगकर्ता या ऐप्लिकेशन को न्योता देना या उसे जोड़ना लेख पढ़ें.

अगर दो लोगों के बीच पहले से कोई डीएम मौजूद है, तो अनुरोध किए जाने के समय एक व्यक्ति के दूसरे को ब्लॉक करने पर भी, मौजूदा डीएम वापस आ जाता है.

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

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

  • https://www.googleapis.com/auth/chat.spaces.create
  • https://www.googleapis.com/auth/chat.spaces
अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

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

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

UpdateMembership

rpc UpdateMembership(UpdateMembershipRequest) returns (Membership)

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

इन तरह के पुष्टि करने के तरीके काम करते हैं:

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

    • https://www.googleapis.com/auth/chat.app.memberships (सिर्फ़ उन स्पेस में जिन्हें ऐप्लिकेशन ने बनाया है)
  • उपयोगकर्ता की पुष्टि, अनुमति के इन स्कोप में से किसी एक के साथ:

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

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.app.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.memberships

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

UpdateMessage

rpc UpdateMessage(UpdateMessageRequest) returns (Message)

यह तरीका, मैसेज को अपडेट करता है. patch और update तरीकों में अंतर होता है. patch तरीका, patch अनुरोध का इस्तेमाल करता है, जबकि update तरीका, put अनुरोध का इस्तेमाल करता है. हमारा सुझाव है कि आप patch तरीके का इस्तेमाल करें. उदाहरण के लिए, मैसेज अपडेट करना देखें.

इन तरह के पुष्टि करने के तरीके काम करते हैं:

ऐप्लिकेशन की पुष्टि करने की सुविधा का इस्तेमाल करने पर, अनुरोध सिर्फ़ उस Chat ऐप्लिकेशन से बनाए गए मैसेज को अपडेट कर सकते हैं जिससे कॉल किया जा रहा है.

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages

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

UpdateSection

rpc UpdateSection(UpdateSectionRequest) returns (Section)

किसी सेक्शन को अपडेट करता है. सिर्फ़ CUSTOM_SECTION टाइप के सेक्शन अपडेट किए जा सकते हैं. ज़्यादा जानकारी के लिए, Google Chat में सेक्शन बनाना और उन्हें व्यवस्थित करना लेख पढ़ें.

इसके लिए, अनुमति के दायरे के साथ उपयोगकर्ता की पुष्टि करना ज़रूरी है:

  • https://www.googleapis.com/auth/chat.users.sections
अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/chat.users.sections

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

UpdateSpace

rpc UpdateSpace(UpdateSpaceRequest) returns (Space)

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

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

ऐप्लिकेशन की पुष्टि करने की सुविधा पर ये सीमाएं लागू होती हैं:

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

इसके लिए, इनमें से किसी एक 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

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

UpdateSpaceNotificationSetting

rpc UpdateSpaceNotificationSetting(UpdateSpaceNotificationSettingRequest) returns (SpaceNotificationSetting)

स्पेस की सूचना पाने की सेटिंग अपडेट करता है. उदाहरण के लिए, कॉल करने वाले व्यक्ति के स्पेस की सूचना पाने की सेटिंग अपडेट करना देखें.

इसके लिए, अनुमति के दायरे के साथ उपयोगकर्ता की पुष्टि करना ज़रूरी है:

  • https://www.googleapis.com/auth/chat.users.spacesettings
अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/chat.users.spacesettings

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

UpdateSpaceReadState

rpc UpdateSpaceReadState(UpdateSpaceReadStateRequest) returns (SpaceReadState)

यह कुकी, किसी स्पेस में उपयोगकर्ता के पढ़े गए मैसेज की स्थिति को अपडेट करती है. इसका इस्तेमाल, पढ़े गए और नहीं पढ़े गए मैसेज की पहचान करने के लिए किया जाता है. उदाहरण के लिए, किसी उपयोगकर्ता के स्पेस को पढ़ने की स्थिति अपडेट करना देखें.

इसके लिए, अनुमति के दायरे के साथ उपयोगकर्ता की पुष्टि करना ज़रूरी है:

  • https://www.googleapis.com/auth/chat.users.readstate
अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/chat.users.readstate

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

AccessoryWidget

एक या उससे ज़्यादा इंटरैक्टिव विजेट, जो मैसेज के सबसे नीचे दिखते हैं. ज़्यादा जानकारी के लिए, मैसेज के सबसे नीचे इंटरैक्टिव विजेट जोड़ना लेख पढ़ें.

फ़ील्ड
यूनियन फ़ील्ड action. कार्रवाई किस तरह की है. action इनमें से सिर्फ़ एक हो सकता है:
button_list

ButtonList

बटन की सूची.

ActionResponse

ऐसे पैरामीटर जिनका इस्तेमाल करके, Chat ऐप्लिकेशन यह कॉन्फ़िगर कर सकता है कि उसके जवाब को कैसे पोस्ट किया जाए.

फ़ील्ड
type

ResponseType

सिर्फ़ इनपुट. यह Chat ऐप्लिकेशन के जवाब का टाइप है.

url

string

सिर्फ़ इनपुट. यह उपयोगकर्ताओं के लिए, पुष्टि करने या कॉन्फ़िगर करने का यूआरएल है. (सिर्फ़ REQUEST_CONFIG तरह के जवाबों के लिए.)

dialog_action

DialogAction

सिर्फ़ इनपुट. यह डायलॉग से जुड़े इंटरैक्शन इवेंट का जवाब है. इसके साथ ResponseType.Dialog होना ज़रूरी है.

updated_widget

UpdatedWidget

सिर्फ़ इनपुट के लिए. अपडेट किए गए विजेट का जवाब.

ResponseType

Chat ऐप्लिकेशन से मिले जवाब का टाइप.

Enums
TYPE_UNSPECIFIED डिफ़ॉल्ट टाइप, जिसे NEW_MESSAGE के तौर पर हैंडल किया जाता है.
NEW_MESSAGE विषय में नया मैसेज पोस्ट करें.
UPDATE_MESSAGE Chat ऐप्लिकेशन के मैसेज को अपडेट करें. इस सुविधा का इस्तेमाल सिर्फ़ CARD_CLICKED इवेंट में किया जा सकता है. साथ ही, मैसेज भेजने वाले का टाइप BOT होना चाहिए.
UPDATE_USER_MESSAGE_CARDS किसी उपयोगकर्ता के मैसेज में मौजूद कार्ड अपडेट करें. इसकी अनुमति सिर्फ़ तब दी जाती है, जब यह MESSAGE इवेंट के जवाब में हो और उसका यूआरएल मैच हो रहा हो या यह CARD_CLICKED इवेंट के जवाब में हो और मैसेज भेजने वाले का टाइप HUMAN हो. टेक्स्ट को अनदेखा किया जाता है.
REQUEST_CONFIG उपयोगकर्ता से निजी तौर पर, पुष्टि करने या कॉन्फ़िगरेशन के बारे में ज़्यादा जानकारी मांगें.
DIALOG यह एक डायलॉग दिखाता है.
UPDATE_WIDGET विजेट में टेक्स्ट अपने-आप पूरा होने के विकल्पों के बारे में क्वेरी.

SelectionItems

विजेट के लिए, अपने-आप पूरे होने वाले नतीजों की सूची.

फ़ील्ड
items[]

SelectionItem

SelectionItem ऑब्जेक्ट का कलेक्शन.

UpdatedWidget

selectionInput विजेट के लिए, यह फ़ंक्शन एक से ज़्यादा आइटम चुनने वाले मेन्यू के लिए, अपने-आप पूरा होने के सुझाव दिखाता है.

फ़ील्ड
widget

string

अपडेट किए गए विजेट का आईडी. यह आईडी, उस विजेट के आईडी से मेल खाना चाहिए जिसने अपडेट का अनुरोध किया है.

यूनियन फ़ील्ड updated_widget. उपयोगकर्ता की कार्रवाई के जवाब में अपडेट किया गया विजेट. updated_widget इनमें से सिर्फ़ एक हो सकता है:
suggestions

SelectionItems

विजेट के लिए, अपने-आप पूरे होने वाले नतीजों की सूची

ActionStatus

इससे, डायलॉग को शुरू करने या सबमिट करने के अनुरोध की स्थिति के बारे में पता चलता है.

फ़ील्ड
status_code

Code

स्टेटस कोड.

user_facing_message

string

उपयोगकर्ताओं को उनके अनुरोध की स्थिति के बारे में भेजने के लिए मैसेज. अगर इसे सेट नहीं किया जाता है, तो status_code के आधार पर एक सामान्य मैसेज भेजा जाता है.

व्याख्या

सिर्फ़ आउटपुट के लिए. एनोटेशन को मैसेज के सादे टेक्स्ट वाले मुख्य हिस्से या Google Workspace के संसाधनों से लिंक करने वाले चिप से जोड़ा जा सकता है. जैसे, Google Docs या Sheets में start_index और length का 0. टेक्स्ट मैसेज में बेसिक फ़ॉर्मैटिंग जोड़ने के लिए, टेक्स्ट मैसेज फ़ॉर्मैट करना लेख पढ़ें.

सामान्य टेक्स्ट वाले मैसेज के मुख्य हिस्से का उदाहरण:

Hello @FooBot how are you!"

इससे जुड़े एनोटेशन का मेटाडेटा:

"annotations":[{
  "type":"USER_MENTION",
  "startIndex":6,
  "length":7,
  "userMention": {
    "user": {
      "name":"users/{user}",
      "displayName":"FooBot",
      "avatarUrl":"https://goo.gl/aeDtrS",
      "type":"BOT"
    },
    "type":"MENTION"
   }
}]
फ़ील्ड
type

AnnotationType

यह एनोटेशन किस तरह का है.

length

int32

यह एनोटेशन, सादे टेक्स्ट वाले मैसेज के मुख्य हिस्से में मौजूद जिस सबस्ट्रिंग से मेल खाता है उसकी लंबाई. अगर यह मौजूद नहीं है, तो इसका मतलब है कि इसकी लंबाई 0 है.

start_index

int32

यह एनोटेशन, सादे टेक्स्ट वाले मैसेज के मुख्य हिस्से के जिस हिस्से से जुड़ा है उसका शुरुआती इंडेक्स. यह इंडेक्स, 0 से शुरू होता है और इसमें शामिल होता है.

यूनियन फ़ील्ड metadata. एनोटेशन के बारे में अतिरिक्त मेटाडेटा. metadata इनमें से सिर्फ़ एक हो सकता है:
user_mention

UserMentionMetadata

उपयोगकर्ता को टैग करने से जुड़ा मेटाडेटा.

slash_command

SlashCommandMetadata

स्लैश कमांड का मेटाडेटा.

custom_emoji_metadata

CustomEmojiMetadata

कस्टम इमोजी का मेटाडेटा.

AnnotationType

एनोटेशन का टाइप.

Enums
ANNOTATION_TYPE_UNSPECIFIED इनम की डिफ़ॉल्ट वैल्यू. इसका इस्तेमाल न करें.
USER_MENTION किसी उपयोगकर्ता को टैग किया गया हो.
SLASH_COMMAND स्लैश कमांड शुरू की जाती है.
CUSTOM_EMOJI कस्टम इमोजी एनोटेशन.

AppCommandMetadata

Chat ऐप्लिकेशन के कमांड के बारे में मेटाडेटा.

फ़ील्ड
app_command_id

int32

Chat API कॉन्फ़िगरेशन में दी गई कमांड का आईडी.

app_command_type

AppCommandType

Chat ऐप्लिकेशन में इस्तेमाल की गई कमांड का टाइप.

AppCommandType

Chat ऐप्लिकेशन में इस्तेमाल की गई कमांड का टाइप. ज़्यादा जानकारी के लिए, Chat ऐप्लिकेशन की कमांड के टाइप देखें.

Enums
APP_COMMAND_TYPE_UNSPECIFIED डिफ़ॉल्ट मान. नहीं बताया गया है
SLASH_COMMAND स्लैश कमांड. उपयोगकर्ता, Chat मैसेज में कमांड भेजता है.
QUICK_COMMAND क्विक कमांड. उपयोगकर्ता, मैसेज के जवाब वाले बॉक्स में मौजूद Chat मेन्यू से कमांड चुनता है.
MESSAGE_ACTION यह मैसेज पर कार्रवाई है. इसमें उपयोगकर्ता, Chat में मैसेज के कॉन्टेक्स्ट मेन्यू से कमांड चुनता है.

AttachedGif

यूआरएल से तय की गई GIF इमेज.

फ़ील्ड
uri

string

सिर्फ़ आउटपुट के लिए. वह यूआरएल जो GIF इमेज को होस्ट करता है.

अटैचमेंट

Google Chat में मौजूद कोई अटैचमेंट.

फ़ील्ड
name

string

पहचान करने वाला. अटैचमेंट का संसाधन नाम.

फ़ॉर्मैट: spaces/{space}/messages/{message}/attachments/{attachment}.

content_name

string

सिर्फ़ आउटपुट के लिए. कॉन्टेंट की ओरिजनल फ़ाइल का नाम, न कि पूरा पाथ.

content_type

string

सिर्फ़ आउटपुट के लिए. फ़ाइल का कॉन्टेंट टाइप (एमआईएमई टाइप).

thumbnail_uri

string

सिर्फ़ आउटपुट के लिए. थंबनेल का वह यूआरएल जिसका इस्तेमाल, किसी व्यक्ति को अटैचमेंट की झलक दिखाने के लिए किया जाना चाहिए. चैट ऐप्लिकेशन को अटैचमेंट का कॉन्टेंट डाउनलोड करने के लिए, इस यूआरएल का इस्तेमाल नहीं करना चाहिए.

download_uri

string

सिर्फ़ आउटपुट. यह डाउनलोड यूआरएल है. इसका इस्तेमाल करके, कोई व्यक्ति अटैचमेंट डाउनलोड कर सकता है. चैट ऐप्लिकेशन को अटैचमेंट का कॉन्टेंट डाउनलोड करने के लिए, इस यूआरएल का इस्तेमाल नहीं करना चाहिए.

source

Source

सिर्फ़ आउटपुट के लिए. अटैचमेंट का सोर्स.

यूनियन फ़ील्ड data_ref. अटैचमेंट का डेटा रेफ़रंस. data_ref इनमें से सिर्फ़ एक हो सकता है:
attachment_data_ref

AttachmentDataRef

ज़रूरी नहीं. अटैचमेंट के डेटा का रेफ़रंस. इस फ़ील्ड का इस्तेमाल, अटैचमेंट वाले मैसेज बनाने या अपडेट करने के लिए किया जाता है. इसके अलावा, इसका इस्तेमाल मीडिया एपीआई के साथ अटैचमेंट डेटा डाउनलोड करने के लिए भी किया जाता है.

drive_data_ref

DriveDataRef

सिर्फ़ आउटपुट. Google Drive में मौजूद अटैचमेंट का रेफ़रंस. इस फ़ील्ड का इस्तेमाल Google Drive API के साथ किया जाता है.

स्रोत

अटैचमेंट का सोर्स.

Enums
SOURCE_UNSPECIFIED रिज़र्व किया गया.
DRIVE_FILE फ़ाइल, Google Drive में मौजूद कोई फ़ाइल है.
UPLOADED_CONTENT फ़ाइल को Chat पर अपलोड किया जाता है.

AttachmentDataRef

अटैचमेंट के डेटा का रेफ़रंस.

फ़ील्ड
resource_name

string

ज़रूरी नहीं. अटैचमेंट डेटा का संसाधन नाम. इस फ़ील्ड का इस्तेमाल, मीडिया एपीआई के साथ किया जाता है. इससे अटैचमेंट का डेटा डाउनलोड किया जाता है.

attachment_upload_token

string

ज़रूरी नहीं. अपलोड किए गए अटैचमेंट का रेफ़रंस देने वाला अपारदर्शी टोकन. क्लाइंट इसे ओपेक स्ट्रिंग के तौर पर इस्तेमाल करते हैं. इसका इस्तेमाल, अटैचमेंट वाले Chat मैसेज बनाने या अपडेट करने के लिए किया जाता है.

CalendarEventLinkData

कैलेंडर इवेंट के लिंक का डेटा.

फ़ील्ड
calendar_id

string

लिंक किए गए कैलेंडर का कैलेंडर आइडेंटिफ़ायर.

event_id

string

लिंक किए गए Calendar इवेंट का इवेंट आइडेंटिफ़ायर.

CardWithId

Google Chat मैसेज में मौजूद कार्ड.

चैट ऐप्लिकेशन, ऐप्लिकेशन की पुष्टि की सुविधा वाले कार्ड बना सकते हैं. डेवलपर प्रीव्यू प्रोग्राम के तहत, अगर आपका Chat ऐप्लिकेशन उपयोगकर्ता के तौर पर पुष्टि करता है, तो वह कार्ड मैसेज बना सकता है. अगर आपका Chat ऐप्लिकेशन, Developer Preview Program का हिस्सा नहीं है, तो वह उपयोगकर्ता की पुष्टि करने वाले कार्ड नहीं बना सकता.

कार्ड वाला मैसेज बनाने का तरीका जानने के लिए, मैसेज भेजना लेख पढ़ें.

कार्ड बिल्डर की मदद से, कार्ड डिज़ाइन करें और उनकी झलक देखें.

कार्ड बिल्डर खोलें

फ़ील्ड
card_id

string

अगर मैसेज में एक से ज़्यादा कार्ड शामिल हैं, तो यह फ़ील्ड ज़रूरी है. यह मैसेज में मौजूद किसी कार्ड के लिए यूनीक आइडेंटिफ़ायर होता है.

card

Card

कार्ड. ज़्यादा से ज़्यादा 32 केबी.

ChatSpaceLinkData

Chat स्पेस के लिंक का डेटा.

फ़ील्ड
space

string

लिंक किए गए Chat स्पेस रिसॉर्स का स्पेस.

फ़ॉर्मैट: spaces/{space}

thread

string

लिंक किए गए Chat स्पेस रिसॉर्स का थ्रेड.

फ़ॉर्मैट: spaces/{space}/threads/{thread}

message

string

लिंक किए गए Chat स्पेस रिसॉर्स का मैसेज.

फ़ॉर्मैट: spaces/{space}/messages/{message}

CompleteImportSpaceRequest

किसी स्पेस के लिए, इंपोर्ट की प्रोसेस पूरी करने का अनुरोध करने वाला मैसेज.

फ़ील्ड
name

string

ज़रूरी है. इंपोर्ट मोड वाले स्पेस का संसाधन नाम.

फ़ॉर्मैट: spaces/{space}

CompleteImportSpaceResponse

स्पेस के लिए, इंपोर्ट की प्रोसेस पूरी होने पर मिलने वाला जवाब.

फ़ील्ड
space

Space

इंपोर्ट मोड स्पेस.

ContextualAddOnMarkup

इस टाइप में कोई फ़ील्ड नहीं है.

डेवलपर के लिए मार्कअप, ताकि वे कॉन्टेक्स्ट के हिसाब से काम करने वाले ऐडऑन का कॉन्टेंट तय कर सकें.

कार्ड

कार्ड, यूज़र इंटरफ़ेस (यूआई) का एक एलिमेंट होता है. इसमें यूज़र इंटरफ़ेस (यूआई) विजेट शामिल हो सकते हैं. जैसे, टेक्स्ट और इमेज.

फ़ील्ड
header

CardHeader

कार्ड का हेडर. हेडर में आम तौर पर एक टाइटल और एक इमेज होती है.

sections[]

Section

सेक्शन को लाइन डिवाइडर से अलग किया जाता है.

card_actions[]

CardAction

इस कार्ड की कार्रवाइयां.

name

string

कार्ड का नाम.

CardAction

कार्ड ऐक्शन, कार्ड से जुड़ी कार्रवाई होती है. इनवॉइस कार्ड के लिए, सामान्य कार्रवाई यह होगी: इनवॉइस मिटाना, इनवॉइस ईमेल करना या ब्राउज़र में इनवॉइस खोलना.

यह सुविधा, Google Chat ऐप्लिकेशन पर काम नहीं करती.

फ़ील्ड
action_label

string

यह लेबल, ऐक्शन मेन्यू आइटम में दिखता था.

on_click

OnClick

इस ऐक्शन आइटम के लिए, onclick ऐक्शन.

CardHeader

फ़ील्ड
title

string

टाइटल देना ज़रूरी है. हेडर की लंबाई तय होती है: अगर टाइटल और सबटाइटल, दोनों दिए गए हैं, तो हर एक के लिए एक लाइन इस्तेमाल की जाती है. अगर सिर्फ़ टाइटल दिया गया है, तो यह दोनों लाइनों में दिखेगा.

subtitle

string

कार्ड हेडर का सबटाइटल.

image_style

ImageStyle

इमेज का टाइप (उदाहरण के लिए, स्क्वेयर बॉर्डर या गोलाकार बॉर्डर).

image_url

string

कार्ड हेडर में मौजूद इमेज का यूआरएल.

ImageStyle

Enums
IMAGE_STYLE_UNSPECIFIED
IMAGE स्क्वेयर बॉर्डर.
AVATAR सर्कुलर बॉर्डर.

सेक्शन

सेक्शन में विजेट का कलेक्शन होता है. इन्हें उसी क्रम में रेंडर किया जाता है जिस क्रम में इन्हें सेट किया गया है. सभी प्लैटफ़ॉर्म पर, कार्ड की चौड़ाई कम होती है. इसलिए, फ़िलहाल लेआउट प्रॉपर्टी (जैसे, फ़्लोट) की ज़रूरत नहीं है.

फ़ील्ड
header

string

सेक्शन का हेडर. फ़ॉर्मैट किए गए टेक्स्ट का इस्तेमाल किया जा सकता है. टेक्स्ट को फ़ॉर्मैट करने के बारे में ज़्यादा जानने के लिए, Google Chat ऐप्लिकेशन में टेक्स्ट को फ़ॉर्मैट करना और Google Workspace ऐड-ऑन में टेक्स्ट को फ़ॉर्मैट करना लेख पढ़ें.

widgets[]

WidgetMarkup

किसी सेक्शन में कम से कम एक विजेट होना चाहिए.

CreateCustomEmojiRequest

पसंद के मुताबिक इमोजी बनाने का अनुरोध.

फ़ील्ड
custom_emoji

CustomEmoji

ज़रूरी है. बनाया जाने वाला कस्टम इमोजी.

CreateMembershipRequest

सदस्यता बनाने के लिए अनुरोध करने वाला मैसेज.

फ़ील्ड
parent

string

ज़रूरी है. उस स्पेस का संसाधन नाम जिसके लिए सदस्यता बनानी है.

फ़ॉर्मैट: spaces/{space}

membership

Membership

ज़रूरी है. सदस्यता का वह संबंध जिसे बनाना है.

memberType फ़ील्ड में, ऐसा उपयोगकर्ता होना चाहिए जिसके user.name और user.type फ़ील्ड में जानकारी मौजूद हो. सर्वर, संसाधन का नाम असाइन करेगा और बताई गई किसी भी जानकारी को बदल देगा.

जब कोई Chat ऐप्लिकेशन, किसी व्यक्ति के लिए सदस्यता का संबंध बनाता है, तो उसे कुछ अनुमति के दायरे का इस्तेमाल करना होगा. साथ ही, कुछ फ़ील्ड के लिए खास वैल्यू सेट करनी होंगी:

  • उपयोगकर्ता के तौर पर पुष्टि करते समय, chat.memberships अनुमति का दायरा ज़रूरी है.

  • ऐप्लिकेशन के तौर पर पुष्टि करते समय, chat.app.memberships अनुमति का दायरा ज़रूरी है.

  • user.type को HUMAN पर सेट करें. साथ ही, user.name को users/{user} फ़ॉर्मैट में सेट करें. यहां {user}, उपयोगकर्ता का ईमेल पता हो सकता है. एक ही Workspace संगठन के उपयोगकर्ताओं के लिए {user}, People API में मौजूद व्यक्ति का id या Directory API में मौजूद उपयोगकर्ता का id भी हो सकता है. उदाहरण के लिए, अगर user@example.com के लिए People API की पर्सन प्रोफ़ाइल आईडी 123456789 है, तो membership.member.name को users/user@example.com या users/123456789 पर सेट करके, उपयोगकर्ता को स्पेस में जोड़ा जा सकता है.

स्पेस का मालिकाना हक रखने वाले Workspace संगठन से बाहर के उपयोगकर्ताओं को न्योता भेजने के लिए, उपयोगकर्ता की पुष्टि करना ज़रूरी है.

जब कोई Chat ऐप्लिकेशन, खुद के लिए सदस्यता का संबंध बनाता है, तो उसे उपयोगकर्ता के तौर पर पुष्टि करनी होगी. साथ ही, उसे chat.memberships.app स्कोप का इस्तेमाल करना होगा, user.type को BOT पर सेट करना होगा, और user.name को users/app पर सेट करना होगा.

use_admin_access

bool

ज़रूरी नहीं. जब true होता है, तो यह तरीका उपयोगकर्ता के Google Workspace एडमिन के अधिकारों का इस्तेमाल करके काम करता है.

कॉल करने वाला व्यक्ति, Google Workspace एडमिन होना चाहिए. साथ ही, उसके पास चैट और स्पेस में होने वाली बातचीत को मैनेज करने का अधिकार होना चाहिए.

इसके लिए, chat.admin.memberships OAuth 2.0 स्कोप की ज़रूरत होती है.

एडमिन ऐक्सेस का इस्तेमाल करके, ऐप्लिकेशन की सदस्यताएं नहीं बनाई जा सकतीं. इसके अलावा, एडमिन के Google Workspace संगठन से बाहर के उपयोगकर्ताओं के लिए सदस्यताएं भी नहीं बनाई जा सकतीं.

CreateMessageNotificationOptions

मैसेज पोस्ट होने पर सूचना पाने के तरीके के विकल्प.

फ़ील्ड
notification_type

NotificationType

मैसेज के लिए सूचना का टाइप.

NotificationType

मैसेज के लिए सूचना के टाइप के विकल्प.

Enums
NOTIFICATION_TYPE_NONE डिफ़ॉल्ट सेटिंग. सूचना मिलने का तरीका, तब जैसा होता है, जब कोई व्यक्ति Chat के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके मैसेज भेजता है. यानी, मैसेज भेजने वाले व्यक्ति को कोई सूचना नहीं मिलती है.
NOTIFICATION_TYPE_FORCE_NOTIFY

मैसेज पाने वालों को सूचना दें. इससे, उपयोगकर्ताओं के स्पेस की सूचना सेटिंग और Chat की 'परेशान न करें' सेटिंग को अनदेखा किया जाता है. इस विकल्प से, डिवाइस-लेवल पर 'परेशान न करें' मोड की सेटिंग बायपास नहीं होती हैं.

इसके लिए, ऐप्लिकेशन की पुष्टि करना ज़रूरी है.

NOTIFICATION_TYPE_SILENT

सूचना को इस तरह से म्यूट करें कि जैसे पाने वाले लोगों ने Chat में 'परेशान न करें' सुविधा चालू की हो या स्पेस को म्यूट किया हो.

इसके लिए, ऐप्लिकेशन की पुष्टि करना ज़रूरी है.

CreateMessagePinRequest

मैसेज पिन करने का अनुरोध करने के लिए मैसेज.

फ़ील्ड
parent

string

ज़रूरी है. वह पैरंट स्पेस जिसमें मैसेज पिन करना है. फ़ॉर्मैट: spaces/{space}

message_pin

MessagePin

ज़रूरी है. बनाने के लिए MessagePin.

CreateMessageRequest

मैसेज बनाता है.

फ़ील्ड
parent

string

ज़रूरी है. उस स्पेस का संसाधन नाम जिसमें मैसेज बनाना है.

फ़ॉर्मैट: spaces/{space}

message

Message

ज़रूरी है. मैसेज का मुख्य हिस्सा.

thread_key
(deprecated)

string

ज़रूरी नहीं. इस्तेमाल बंद कर दिया गया है: इसके बजाय, thread.thread_key का इस्तेमाल करें. थ्रेड का आईडी. इसमें ज़्यादा से ज़्यादा 4,000 वर्ण इस्तेमाल किए जा सकते हैं. कोई थ्रेड शुरू करने या उसमें कुछ जोड़ने के लिए, कोई मैसेज बनाएं और उसमें threadKey या thread.name जोड़ें. इसे इस्तेमाल करने के तरीके के बारे में जानने के लिए, मैसेज थ्रेड शुरू करना या उसका जवाब देना लेख पढ़ें.

request_id

string

ज़रूरी नहीं. इस मैसेज के लिए यूनीक अनुरोध आईडी. मौजूदा अनुरोध आईडी तय करने पर, नया मैसेज बनाने के बजाय, उस आईडी से बनाया गया मैसेज दिखता है.

message_reply_option

MessageReplyOption

ज़रूरी नहीं. इससे पता चलता है कि कोई मैसेज थ्रेड शुरू करता है या किसी थ्रेड का जवाब देता है. यह सुविधा सिर्फ़ नाम वाले स्पेस में काम करती है.

उपयोगकर्ता के इंटरैक्शन का जवाब देते समय, इस फ़ील्ड को अनदेखा कर दिया जाता है. थ्रेड में की गई बातचीत के लिए, जवाब उसी थ्रेड में बनाया जाता है. अगर ऐसा नहीं किया जाता है, तो जवाब को नई थ्रेड के तौर पर बनाया जाता है.

message_id

string

ज़रूरी नहीं. मैसेज के लिए कस्टम आईडी. इस सुविधा की मदद से, चैट ऐप्लिकेशन को सिस्टम की ओर से असाइन किया गया आईडी सेव किए बिना, मैसेज पाने, अपडेट करने या मिटाने की अनुमति मिलती है. यह आईडी, मैसेज के संसाधन के नाम (मैसेज name फ़ील्ड में दिखाया गया है) में मौजूद होता है.

इस फ़ील्ड की वैल्यू इन ज़रूरी शर्तों के मुताबिक होनी चाहिए:

  • client- से शुरू होता है. उदाहरण के लिए, client-custom-name एक मान्य कस्टम आईडी है, लेकिन custom-name नहीं.
  • इसमें ज़्यादा से ज़्यादा 63 वर्ण हो सकते हैं. साथ ही, इसमें सिर्फ़ अंग्रेज़ी के छोटे अक्षर, संख्याएं, और हाइफ़न इस्तेमाल किए जा सकते हैं.
  • यह किसी स्पेस में यूनीक होता है. Chat ऐप्लिकेशन, अलग-अलग मैसेज के लिए एक ही कस्टम आईडी का इस्तेमाल नहीं कर सकता.

ज़्यादा जानकारी के लिए, किसी मैसेज को नाम देना लेख पढ़ें.

create_message_notification_options

CreateMessageNotificationOptions

ज़रूरी नहीं. इस कुकी से यह कंट्रोल किया जाता है कि मैसेज पोस्ट किए जाने पर सूचना कैसे भेजी जाए. ज़्यादा जानने के लिए, सूचनाएं पाने के लिए मजबूर करना या साइलेंट मैसेज भेजना लेख पढ़ें.

MessageReplyOption

इससे यह तय होता है कि किसी मैसेज का जवाब कैसे देना है. आने वाले समय में, इसमें और राज्य जोड़े जा सकते हैं.

Enums
MESSAGE_REPLY_OPTION_UNSPECIFIED डिफ़ॉल्ट. इससे नया थ्रेड शुरू होता है. इस विकल्प का इस्तेमाल करने पर, शामिल किए गए किसी भी thread ID या thread_key को अनदेखा कर दिया जाता है.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD इस विकल्प का इस्तेमाल करके, मैसेज को thread ID या thread_key में दिए गए थ्रेड के जवाब के तौर पर बनाया जाता है. अगर ऐसा नहीं होता है, तो मैसेज से नई थ्रेड शुरू हो जाती है.
REPLY_MESSAGE_OR_FAIL thread ID या thread_key में दी गई थ्रेड के जवाब के तौर पर मैसेज बनाता है. अगर नए thread_key का इस्तेमाल किया जाता है, तो नई थ्रेड बनाई जाती है. अगर मैसेज नहीं बन पाता है, तो NOT_FOUND गड़बड़ी का मैसेज दिखता है.

CreateReactionRequest

किसी मैसेज पर प्रतिक्रिया देता है.

फ़ील्ड
parent

string

ज़रूरी है. वह मैसेज जिस पर प्रतिक्रिया दी गई है.

फ़ॉर्मैट: spaces/{space}/messages/{message}

reaction

Reaction

ज़रूरी है. प्रतिक्रिया बनाने के लिए.

CreateSectionRequest

सेक्शन बनाने के लिए अनुरोध करने वाला मैसेज.

फ़ील्ड
parent

string

ज़रूरी है. पैरंट रिसॉर्स का वह नाम जहां सेक्शन बनाया गया है.

फ़ॉर्मैट: users/{user}

section

Section

ज़रूरी है. बनाया जाने वाला सेक्शन.

CreateSpaceRequest

बिना सदस्यों वाला स्पेस बनाने का अनुरोध.

फ़ील्ड
space

Space

ज़रूरी है. displayName और spaceType फ़ील्ड में वैल्यू मौजूद होनी चाहिए. सिर्फ़ SpaceType.SPACE और SpaceType.GROUP_CHAT वैल्यू इस्तेमाल की जा सकती हैं. SpaceType.GROUP_CHAT का इस्तेमाल सिर्फ़ तब किया जा सकता है, जब importMode को 'सही है' पर सेट किया गया हो.

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

name स्पेस सर्वर पर असाइन किया जाता है. इसलिए, इस फ़ील्ड में दी गई किसी भी वैल्यू को अनदेखा कर दिया जाएगा.

request_id

string

ज़रूरी नहीं. इस अनुरोध के लिए यूनीक आइडेंटिफ़ायर. हमारा सुझाव है कि आप रैंडम यूयूआईडी का इस्तेमाल करें. मौजूदा अनुरोध आईडी तय करने पर, नया स्पेस बनाने के बजाय, उस आईडी से बनाया गया स्पेस दिखता है. पुष्टि किए गए किसी दूसरे उपयोगकर्ता के साथ, उसी Chat ऐप्लिकेशन से मौजूदा अनुरोध आईडी तय करने पर गड़बड़ी होती है.

CustomEmoji

यह कस्टम इमोजी को दिखाता है.

फ़ील्ड
name

string

पहचानकर्ता. सर्वर की ओर से असाइन किया गया, कस्टम इमोजी के संसाधन का नाम.

फ़ॉर्मैट: customEmojis/{customEmoji}

uid

string

सिर्फ़ आउटपुट के लिए. कस्टम इमोजी रिसॉर्स के लिए यूनीक कुंजी.

emoji_name

string

ज़रूरी नहीं. इम्यूटेबल. उपयोगकर्ता की ओर से दिया गया कस्टम इमोजी का नाम. यह नाम संगठन में यूनीक होता है.

कस्टम इमोजी बनाते समय यह फ़ील्ड ज़रूरी होता है. हालांकि, अन्य मामलों में सिर्फ़ आउटपुट के लिए इसका इस्तेमाल किया जाता है.

इमोजी के नाम कोलन से शुरू और खत्म होने चाहिए. साथ ही, इनमें सिर्फ़ अंग्रेज़ी के छोटे अक्षर इस्तेमाल करें. इनमें अक्षर और अंक, हाइफ़न, और अंडरस्कोर ही शामिल किए जा सकते हैं. हाइफ़न और अंडरस्कोर का इस्तेमाल, एक-दूसरे के बगल में नहीं किया जाना चाहिए. इन्हें शब्दों को अलग करने के लिए शामिल किया जाना चाहिए.

उदाहरण: :valid-emoji-name:

temporary_image_uri

string

सिर्फ़ आउटपुट के लिए. कस्टम इमोजी के लिए, कुछ समय के लिए मान्य इमेज यूआरएल. यह कम से कम 10 मिनट तक मान्य रहता है. ध्यान दें कि कस्टम इमोजी बनाते समय, इसे जवाब में नहीं भरा जाता है.

payload

CustomEmojiPayload

ज़रूरी नहीं. सिर्फ़ इनपुट के लिए. पेलोड डेटा. कस्टम इमोजी बनाते समय इसकी ज़रूरत होती है.

CustomEmojiPayload

कस्टम इमोजी के लिए पेलोड डेटा.

फ़ील्ड
file_content

bytes

ज़रूरी है. सिर्फ़ इनपुट के लिए. कस्टम इमोजी के लिए इस्तेमाल की गई इमेज.

पेलोड का साइज़ 256 केबी से कम होना चाहिए. साथ ही, इमेज का डाइमेंशन स्क्वेयर होना चाहिए और यह 64 से 500 पिक्सल के बीच होनी चाहिए. इन पाबंदियों में बदलाव किया जा सकता है.

filename

string

ज़रूरी है. सिर्फ़ इनपुट के लिए. इमेज फ़ाइल का नाम.

इन फ़ाइल एक्सटेंशन का इस्तेमाल किया जा सकता है: .png, .jpg, .gif.

CustomEmojiMetadata

कस्टम इमोजी के लिए एनोटेशन मेटाडेटा.

फ़ील्ड
custom_emoji

CustomEmoji

कस्टम इमोजी.

DeleteCustomEmojiRequest

पसंद के मुताबिक बनाए गए इमोजी को मिटाने का अनुरोध.

फ़ील्ड
name

string

ज़रूरी है. मिटाने के लिए, पसंद के मुताबिक बनाए गए इमोजी के संसाधन का नाम.

फ़ॉर्मैट: customEmojis/{customEmoji}

इमोजी के नाम का इस्तेमाल, {customEmoji} के लिए एलियास के तौर पर किया जा सकता है. उदाहरण के लिए, customEmojis/:example-emoji:, जहां :example-emoji:, पसंद के मुताबिक बनाए गए इमोजी का नाम है.

DeleteMembershipRequest

किसी स्पेस में सदस्यता मिटाने का अनुरोध.

फ़ील्ड
name

string

ज़रूरी है. पैसे चुकाकर ली गई सदस्यता का संसाधन नाम, जिसे मिटाना है. चैट ऐप्लिकेशन, इंसानों या खुद की सदस्यताएं मिटा सकते हैं. चैट ऐप्लिकेशन, दूसरे ऐप्लिकेशन की सदस्यताएं नहीं मिटा सकते.

किसी व्यक्ति की सदस्यता मिटाने के लिए, उपयोगकर्ता की पुष्टि के साथ chat.memberships स्कोप या ऐप्लिकेशन की पुष्टि के साथ chat.memberships.app स्कोप और spaces/{space}/members/{member} फ़ॉर्मैट की ज़रूरत होती है. {member} के लिए ईमेल को उपनाम के तौर पर इस्तेमाल किया जा सकता है. उदाहरण के लिए, spaces/{space}/members/example@gmail.com जहां example@gmail.com, Google Chat उपयोगकर्ता का ईमेल है.

किसी ऐप्लिकेशन की सदस्यता मिटाने के लिए, chat.memberships.app स्कोप और spaces/{space}/members/app फ़ॉर्मैट की ज़रूरत होती है.

फ़ॉर्मैट: spaces/{space}/members/{member} या spaces/{space}/members/app.

use_admin_access

bool

ज़रूरी नहीं. जब true होता है, तो यह तरीका उपयोगकर्ता के Google Workspace एडमिन के अधिकारों का इस्तेमाल करके काम करता है.

कॉल करने वाला व्यक्ति, Google Workspace एडमिन होना चाहिए. साथ ही, उसके पास चैट और स्पेस में होने वाली बातचीत को मैनेज करने का अधिकार होना चाहिए.

इसके लिए, chat.admin.memberships OAuth 2.0 स्कोप की ज़रूरत होती है.

एडमिन ऐक्सेस का इस्तेमाल करके, किसी स्पेस में ऐप्लिकेशन की सदस्यताएं मिटाने की सुविधा उपलब्ध नहीं है.

DeleteMessagePinRequest

किसी मैसेज को पिन करने की सुविधा हटाने का अनुरोध.

फ़ील्ड
name

string

ज़रूरी है. मैसेज पिन करने की सुविधा का वह संसाधन नाम जिसे हटाना है. फ़ॉर्मैट: spaces/{space}/messagePins/{message_pin}

DeleteMessageRequest

किसी मैसेज को मिटाने का अनुरोध करें.

फ़ील्ड
name

string

ज़रूरी है. मैसेज के संसाधन का नाम.

फ़ॉर्मैट: spaces/{space}/messages/{message}

अगर आपने अपने मैसेज के लिए कस्टम आईडी सेट किया है, तो {message} के लिए clientAssignedMessageId फ़ील्ड की वैल्यू का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, किसी मैसेज को नाम देना लेख पढ़ें.

force

bool

ज़रूरी नहीं. true में, किसी मैसेज को मिटाने पर थ्रेड में दिए गए जवाब भी मिट जाते हैं. false के दौरान, अगर किसी मैसेज के थ्रेड वाले जवाब हैं, तो उसे मिटाया नहीं जा सकता.

यह सिर्फ़ उपयोगकर्ता के तौर पर पुष्टि करते समय लागू होता है. Chat ऐप्लिकेशन के तौर पर पुष्टि करने पर इसका कोई असर नहीं पड़ता.

DeleteReactionRequest

किसी मैसेज पर दी गई प्रतिक्रिया को मिटाता है.

फ़ील्ड
name

string

ज़रूरी है. मिटाई जाने वाली प्रतिक्रिया का नाम.

फ़ॉर्मैट: spaces/{space}/messages/{message}/reactions/{reaction}

DeleteSectionRequest

किसी सेक्शन को मिटाने के लिए अनुरोध वाला मैसेज.

फ़ील्ड
name

string

ज़रूरी है. मिटाए जाने वाले सेक्शन का नाम.

फ़ॉर्मैट: users/{user}/sections/{section}

DeleteSpaceRequest

स्पेस मिटाने का अनुरोध करना.

फ़ील्ड
name

string

ज़रूरी है. मिटाए जाने वाले स्पेस का संसाधन नाम.

फ़ॉर्मैट: spaces/{space}

use_admin_access

bool

ज़रूरी नहीं. जब true होता है, तो यह तरीका उपयोगकर्ता के Google Workspace एडमिन के अधिकारों का इस्तेमाल करके काम करता है.

कॉल करने वाला व्यक्ति, Google Workspace एडमिन होना चाहिए. साथ ही, उसके पास चैट और स्पेस में होने वाली बातचीत को मैनेज करने का अधिकार होना चाहिए.

इसके लिए, chat.admin.delete OAuth 2.0 स्कोप की ज़रूरत होती है.

DeletionMetadata

मिटाए गए मैसेज के बारे में जानकारी. delete_time सेट होने पर, मैसेज मिटा दिया जाता है.

फ़ील्ड
deletion_type

DeletionType

इससे पता चलता है कि मैसेज किसने मिटाया है.

DeletionType

मैसेज किसने मिटाया और उसे कैसे मिटाया गया. आने वाले समय में, इसमें और वैल्यू जोड़ी जा सकती हैं. मैसेज कब मिटाए जा सकते हैं, इस बारे में जानने के लिए Google Chat में किसी मैसेज में बदलाव करना या उसे मिटाना लेख पढ़ें.

Enums
DELETION_TYPE_UNSPECIFIED इस वैल्यू का इस्तेमाल नहीं किया गया है.
CREATOR उपयोगकर्ता ने अपना मैसेज मिटा दिया है.
SPACE_OWNER किसी मालिक या मैनेजर ने मैसेज मिटा दिया है.
ADMIN Google Workspace के किसी एडमिन ने मैसेज मिटा दिया है. एडमिन, स्पेस में मौजूद किसी भी मैसेज को मिटा सकते हैं. इनमें स्पेस के किसी सदस्य या Chat ऐप्लिकेशन से भेजे गए मैसेज भी शामिल हैं.
APP_MESSAGE_EXPIRY Chat ऐप्लिकेशन ने समयसीमा खत्म होने पर, अपना मैसेज मिटा दिया.
CREATOR_VIA_APP Chat ऐप्लिकेशन ने, मैसेज बनाने वाले व्यक्ति की ओर से मैसेज मिटाया है. इसके लिए, उपयोगकर्ता की पुष्टि करने की सुविधा का इस्तेमाल किया गया है.
SPACE_OWNER_VIA_APP किसी Chat ऐप्लिकेशन ने स्पेस मैनेजर की ओर से मैसेज मिटाया है. इसके लिए, उपयोगकर्ता की पुष्टि करने की सुविधा का इस्तेमाल किया गया है.
SPACE_MEMBER स्पेस के किसी सदस्य ने मैसेज मिटा दिया है. उपयोगकर्ता, ऐप्लिकेशन से भेजे गए मैसेज मिटा सकते हैं.

Dialog

डायलॉग के कार्ड बॉडी के चारों ओर रैपर.

फ़ील्ड
body

Card

सिर्फ़ इनपुट. डायलॉग का मुख्य हिस्सा, जिसे मोडल में रेंडर किया जाता है. Google Chat ऐप्लिकेशन, कार्ड की इन इकाइयों के साथ काम नहीं करते: DateTimePicker, OnChangeAction.

DialogAction

इसमें डायलॉग और अनुरोध की स्थिति का कोड होता है.

फ़ील्ड
action_status

ActionStatus

सिर्फ़ इनपुट. यह डायलॉग को शुरू करने या सबमिट करने के अनुरोध की स्थिति दिखाता है. अगर ज़रूरी हो, तो यह उपयोगकर्ताओं को स्थिति और मैसेज दिखाता है. उदाहरण के लिए, गड़बड़ी या अनुरोध पूरा होने की स्थिति में.

यूनियन फ़ील्ड action. की जाने वाली कार्रवाई. action इनमें से सिर्फ़ एक हो सकता है:
dialog

Dialog

सिर्फ़ इनपुट. अनुरोध के लिए डायलॉग.

DriveDataRef

Drive में मौजूद अटैचमेंट के डेटा का रेफ़रंस.

फ़ील्ड
drive_file_id

string

ड्राइव फ़ाइल का आईडी. इसका इस्तेमाल Drive API के साथ करें.

DriveLinkData

Google Drive के लिंक का डेटा.

फ़ील्ड
drive_data_ref

DriveDataRef

DriveDataRef, जो Google Drive में मौजूद किसी फ़ाइल का रेफ़रंस देता है.

mime_type

string

लिंक किए गए Google Drive संसाधन का MIME टाइप.

इमोजी

किसी मैसेज पर प्रतिक्रिया देने के लिए इस्तेमाल किया जाने वाला इमोजी.

फ़ील्ड
यूनियन फ़ील्ड content. ज़रूरी है. इमोजी का कॉन्टेंट. content इनमें से सिर्फ़ एक हो सकता है:
unicode

string

ज़रूरी नहीं. एक सामान्य इमोजी, जिसे यूनिकोड स्ट्रिंग के तौर पर दिखाया जाता है.

custom_emoji

CustomEmoji

कस्टम इमोजी.

EmojiReactionSummary

ऐसे लोगों की संख्या जिन्होंने किसी मैसेज पर, किसी खास इमोजी का इस्तेमाल करके प्रतिक्रिया दी है.

फ़ील्ड
emoji

Emoji

सिर्फ़ आउटपुट के लिए. प्रतिक्रियाओं से जुड़ा इमोजी.

reaction_count

int32

सिर्फ़ आउटपुट. इससे जुड़े इमोजी का इस्तेमाल करके दी गई प्रतिक्रियाओं की कुल संख्या.

FindDirectMessageRequest

उपयोगकर्ता के संसाधन के आधार पर, डायरेक्ट मैसेज स्पेस पाने का अनुरोध.

फ़ील्ड
name

string

ज़रूरी है. उस उपयोगकर्ता का संसाधन नाम जिसके साथ डायरेक्ट मैसेज ढूंढना है.

फ़ॉर्मैट: users/{user}, जहां {user}, People API में मौजूद व्यक्ति के लिए id या Directory API में मौजूद उपयोगकर्ता के लिए id होता है. उदाहरण के लिए, अगर People API का प्रोफ़ाइल आईडी 123456789 है, तो उस व्यक्ति को भेजे गए डायरेक्ट मैसेज को खोजने के लिए, name के तौर पर users/123456789 का इस्तेमाल करें. उपयोगकर्ता के तौर पर पुष्टि होने पर, ईमेल पते का इस्तेमाल {user} के उपनाम के तौर पर किया जा सकता है. उदाहरण के लिए, users/example@gmail.com जहां example@gmail.com, Google Chat इस्तेमाल करने वाले व्यक्ति का ईमेल पता है.

FindGroupChatsRequest

उपयोगकर्ता के संसाधनों के आधार पर, ग्रुप चैट स्पेस पाने का अनुरोध.

फ़ील्ड
users[]

string

ज़रूरी नहीं. कॉल करने वाले व्यक्ति के साथ ग्रुप चैट में शामिल सभी लोगों के संसाधन के नाम. अनुरोध में चैट ऐप्लिकेशन शामिल नहीं किए जा सकते.

एक अनुरोध में ज़्यादा से ज़्यादा 49 उपयोगकर्ताओं को शामिल किया जा सकता है.

फ़ॉर्मैट: users/{user}, जहां {user}, People API में मौजूद व्यक्ति के लिए id या Directory API में मौजूद उपयोगकर्ता के लिए id होता है. उदाहरण के लिए, कॉल करने वाले उपयोगकर्ता और दो अन्य उपयोगकर्ताओं के साथ की गई सभी ग्रुप चैट ढूंढने के लिए, People API के प्रोफ़ाइल आईडी 123456789 और 987654321 के साथ users/123456789 और users/987654321 का इस्तेमाल किया जा सकता है. इस ईमेल पते का इस्तेमाल, {user} के दूसरे ईमेल पते के तौर पर भी किया जा सकता है. उदाहरण के लिए, users/example@gmail.com जहां example@gmail.com, Google Chat इस्तेमाल करने वाले व्यक्ति का ईमेल पता है.

page_size

int32

ज़रूरी नहीं. ज़्यादा से ज़्यादा कितने स्पेस दिखाने हैं. ऐसा हो सकता है कि सेवा इस वैल्यू से कम नतीजे दिखाए.

अगर यह तय नहीं किया गया है, तो ज़्यादा से ज़्यादा 10 स्पेस दिखाए जाते हैं.

ज़्यादा से ज़्यादा वैल्यू 30 हो सकती है. अगर 30 से ज़्यादा वैल्यू का इस्तेमाल किया जाता है, तो उसे अपने-आप 30 में बदल दिया जाता है.

नेगेटिव वैल्यू डालने पर, INVALID_ARGUMENT गड़बड़ी दिखती है.

page_token

string

ज़रूरी नहीं. यह एक पेज टोकन है. इसे ग्रुप चैट ढूंढने के लिए, पिछले कॉल से मिला है. अगला पेज पाने के लिए, यह पैरामीटर दें.

पेज नंबर बदलते समय, दिए गए अन्य सभी पैरामीटर, टोकन देने वाले कॉल से मेल खाने चाहिए. अलग-अलग वैल्यू पास करने से, अनचाहे नतीजे मिल सकते हैं.

space_view

SpaceView

स्पेस को देखने का अनुरोध किया गया है. अगर इसे सेट नहीं किया जाता है, तो डिफ़ॉल्ट रूप से SPACE_VIEW_RESOURCE_NAME_ONLY पर सेट होता है. SPACE_VIEW_EXPANDED के बारे में बताने वाले अनुरोधों में, ऐसे स्कोप शामिल होने चाहिए जिनसे स्पेस का डेटा पढ़ा जा सके. उदाहरण के लिए, https://www.googleapis.com/auth/chat.spaces या https://www.googleapis.com/auth/chat.spaces.readonly.

FindGroupChatsResponse

जवाब में, ग्रुप चैट स्पेस शामिल होते हैं. इनमें कॉल करने वाला उपयोगकर्ता और अनुरोध करने वाले उपयोगकर्ता शामिल होते हैं.

फ़ील्ड
spaces[]

Space

अनुरोध किए गए (या पहले) पेज पर मौजूद स्पेस की सूची.

next_page_token

string

यह एक ऐसा टोकन है जिसे pageToken के तौर पर भेजा जा सकता है, ताकि नतीजों का अगला पेज वापस पाया जा सके. अगर यह खाली है, तो इसके बाद कोई पेज नहीं है.

ForwardedMetadata

उस सोर्स स्पेस के बारे में मेटाडेटा जिससे मैसेज फ़ॉरवर्ड किया गया था.

फ़ील्ड
space

string

सिर्फ़ आउटपुट के लिए. सोर्स स्पेस का संसाधन नाम. फ़ॉर्मैट: spaces/{space}

space_display_name

string

सिर्फ़ आउटपुट. फ़ॉरवर्ड करते समय, सोर्स स्पेस या डीएम का डिसप्ले नेम. SPACE के लिए, यह स्पेस का नाम होता है. DIRECT_MESSAGE के लिए, यह बातचीत में शामिल दूसरे व्यक्ति का नाम होता है. उदाहरण के लिए, "उपयोगकर्ता A". GROUP_CHAT के लिए, यह सदस्यों के पहले नामों के आधार पर जनरेट किया गया नाम होता है. इसमें क्रिएटर के नाम के साथ-साथ ज़्यादा से ज़्यादा पांच नाम शामिल होते हैं. उदाहरण के लिए, "उपयोगकर्ता A, उपयोगकर्ता B".

GetAttachmentRequest

अटैचमेंट पाने का अनुरोध करें.

फ़ील्ड
name

string

ज़रूरी है. अटैचमेंट का संसाधन नाम, spaces/{space}/messages/{message}/attachments/{attachment} के फ़ॉर्मैट में होता है.

GetCustomEmojiRequest

पसंद के मुताबिक बनाए गए किसी इमोजी को वापस लाने का अनुरोध.

फ़ील्ड
name

string

ज़रूरी है. पसंद के मुताबिक बनाए गए इमोजी का संसाधन नाम.

फ़ॉर्मैट: customEmojis/{customEmoji}

इमोजी के नाम का इस्तेमाल, {customEmoji} के लिए एलियास के तौर पर किया जा सकता है. उदाहरण के लिए, customEmojis/:example-emoji:, जहां :example-emoji:, पसंद के मुताबिक बनाए गए इमोजी का नाम है.

GetMembershipRequest

किसी स्पेस की सदस्यता पाने का अनुरोध करना.

फ़ील्ड
name

string

ज़रूरी है. सदस्यता का संसाधन नाम जिसे वापस पाना है.

उपयोगकर्ता की पुष्टि करने की सुविधा का इस्तेमाल करके, ऐप्लिकेशन की सदस्यता पाने के लिए, spaces/{space}/members/app का इस्तेमाल किया जा सकता है.

फ़ॉर्मैट: spaces/{space}/members/{member} या spaces/{space}/members/app

उपयोगकर्ता के ईमेल पते को {member} के लिए उपनाम के तौर पर इस्तेमाल किया जा सकता है. उदाहरण के लिए, spaces/{space}/members/example@gmail.com, जहां example@gmail.com, Google Chat इस्तेमाल करने वाले व्यक्ति का ईमेल पता है.

use_admin_access

bool

ज़रूरी नहीं. जब true होता है, तो यह तरीका उपयोगकर्ता के Google Workspace एडमिन के अधिकारों का इस्तेमाल करके काम करता है.

कॉल करने वाला व्यक्ति, Google Workspace एडमिन होना चाहिए. साथ ही, उसके पास चैट और स्पेस में होने वाली बातचीत को मैनेज करने का अधिकार होना चाहिए.

इसके लिए, chat.admin.memberships या chat.admin.memberships.readonly OAuth 2.0 स्कोप की ज़रूरत होती है.

एडमिन के तौर पर ऐक्सेस करने पर, किसी स्पेस में ऐप्लिकेशन की सदस्यताएं नहीं ली जा सकतीं.

GetMessageRequest

मैसेज पाने का अनुरोध करें.

फ़ील्ड
name

string

ज़रूरी है. मैसेज के संसाधन का नाम.

फ़ॉर्मैट: spaces/{space}/messages/{message}

अगर आपने अपने मैसेज के लिए कस्टम आईडी सेट किया है, तो {message} के लिए clientAssignedMessageId फ़ील्ड की वैल्यू का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, किसी मैसेज को नाम देना लेख पढ़ें.

GetSpaceEventRequest

स्पेस इवेंट पाने के लिए मैसेज का अनुरोध करें.

फ़ील्ड
name

string

ज़रूरी है. स्पेस इवेंट के रिसॉर्स का नाम.

फ़ॉर्मैट: spaces/{space}/spaceEvents/{spaceEvent}

GetSpaceNotificationSettingRequest

स्पेस की सूचना सेटिंग पाने के लिए अनुरोध मैसेज. इससे सिर्फ़ कॉल करने वाले उपयोगकर्ता की सूचना सेटिंग पाई जा सकती है.

फ़ील्ड
name

string

ज़रूरी है. फ़ॉर्मैट: users/{user}/spaces/{space}/spaceNotificationSetting

  • users/me/spaces/{space}/spaceNotificationSetting या
  • users/user@example.com/spaces/{space}/spaceNotificationSetting या
  • users/123456789/spaces/{space}/spaceNotificationSetting. ध्यान दें: पाथ में सिर्फ़ कॉलर के उपयोगकर्ता आईडी या ईमेल पते का इस्तेमाल किया जा सकता है.

GetSpaceReadStateRequest

GetSpaceReadState API के लिए अनुरोध का मैसेज.

फ़ील्ड
name

string

ज़रूरी है. पढ़ने की स्थिति वाले स्पेस का संसाधन नाम, जिसे वापस पाना है.

यह सिर्फ़ कॉल करने वाले व्यक्ति के लिए, मैसेज पढ़े जाने की स्थिति पाने की सुविधा देता है.

कॉल करने वाले उपयोगकर्ता को रेफ़र करने के लिए, इनमें से कोई एक विकल्प सेट करें:

  • me का दूसरा ईमेल पता. उदाहरण के लिए, users/me/spaces/{space}/spaceReadState.

  • उनका Workspace ईमेल पता. उदाहरण के लिए, users/user@example.com/spaces/{space}/spaceReadState.

  • उनका यूज़र आईडी. उदाहरण के लिए, users/123456789/spaces/{space}/spaceReadState.

फ़ॉर्मैट: users/{user}/spaces/{space}/spaceReadState

GetSpaceRequest

किसी एक स्पेस को वापस लाने का अनुरोध.

फ़ील्ड
name

string

ज़रूरी है. स्पेस का संसाधन नाम, spaces/{space} के फ़ॉर्मैट में होता है.

फ़ॉर्मैट: spaces/{space}

use_admin_access

bool

ज़रूरी नहीं. जब true होता है, तो यह तरीका उपयोगकर्ता के Google Workspace एडमिन के अधिकारों का इस्तेमाल करके काम करता है.

कॉल करने वाला व्यक्ति, Google Workspace एडमिन होना चाहिए. साथ ही, उसके पास चैट और स्पेस में होने वाली बातचीत को मैनेज करने का अधिकार होना चाहिए.

इसके लिए, chat.admin.spaces या chat.admin.spaces.readonly OAuth 2.0 स्कोप की ज़रूरत होती है.

GetThreadReadStateRequest

GetThreadReadStateRequest API के लिए अनुरोध का मैसेज.

फ़ील्ड
name

string

ज़रूरी है. थ्रेड की पढ़ी गई स्थिति को वापस पाने के लिए, रिसॉर्स का नाम.

यह सिर्फ़ कॉल करने वाले व्यक्ति के लिए, मैसेज पढ़े जाने की स्थिति पाने की सुविधा देता है.

कॉल करने वाले उपयोगकर्ता को रेफ़र करने के लिए, इनमें से कोई एक विकल्प सेट करें:

  • me का दूसरा ईमेल पता. उदाहरण के लिए, users/me/spaces/{space}/threads/{thread}/threadReadState.

  • उनका Workspace ईमेल पता. उदाहरण के लिए, users/user@example.com/spaces/{space}/threads/{thread}/threadReadState.

  • उनका यूज़र आईडी. उदाहरण के लिए, users/123456789/spaces/{space}/threads/{thread}/threadReadState.

फ़ॉर्मैट: users/{user}/spaces/{space}/threads/{thread}/threadReadState

ग्रुप

Google Chat में मौजूद कोई Google ग्रुप.

फ़ील्ड
name

string

Google ग्रुप के संसाधन का नाम.

यह Cloud Identity Groups API में ग्रुप को दिखाता है.

फ़ॉर्मैट: groups/{group}

HistoryState

मैसेज और स्पेस के लिए इतिहास की स्थिति. इससे यह तय होता है कि मैसेज और बातचीत के थ्रेड बनाने के बाद, उन्हें कितने समय तक सेव रखा जाएगा.

Enums
HISTORY_STATE_UNSPECIFIED डिफ़ॉल्ट मान. इस्तेमाल न करें.
HISTORY_OFF इतिहास बंद है. मैसेज और थ्रेड 24 घंटे तक सेव रखे जाते हैं.
HISTORY_ON इतिहास चालू है. संगठन के Vault में निजी डेटा के रखरखाव के नियमों में यह बताया जाता है कि मैसेज और थ्रेड को कितने समय तक सेव रखा जाता है.

ListCustomEmojisRequest

पसंद के मुताबिक बनाए गए इमोजी की सूची को वापस पाने का अनुरोध.

फ़ील्ड
page_size

int32

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

page_token

string

ज़रूरी नहीं. (अगर पिछली क्वेरी से काम फिर से शुरू किया जा रहा है.)

यह पेज टोकन, कस्टम इमोजी की पिछली सूची के कॉल से मिला है. अगला पेज वापस पाने के लिए, इसे उपलब्ध कराएं.

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

filter

string

ज़रूरी नहीं. क्वेरी फ़िल्टर.

क्रिएटर के हिसाब से फ़िल्टर करने की सुविधा उपलब्ध है.

क्रिएटर के हिसाब से फ़िल्टर करने के लिए, आपको मान्य वैल्यू डालनी होगी. फ़िलहाल, कस्टम इमोजी को इस आधार पर फ़िल्टर करने के लिए सिर्फ़ creator("users/me") और NOT creator("users/me") स्वीकार किए जाते हैं कि उन्हें कॉल करने वाले उपयोगकर्ता ने बनाया है या नहीं.

उदाहरण के लिए, इस क्वेरी से कॉल करने वाले व्यक्ति के बनाए गए कस्टम इमोजी दिखते हैं:

creator("users/me")

अमान्य क्वेरी को INVALID_ARGUMENT गड़बड़ी के साथ अस्वीकार कर दिया जाता है.

ListCustomEmojisResponse

कस्टम इमोजी की सूची बनाने के लिए जवाब.

फ़ील्ड
custom_emojis[]

CustomEmoji

बिना क्रम वाली सूची. कस्टम इमोजी की सूची.

next_page_token

string

यह एक ऐसा टोकन है जिसे pageToken के तौर पर भेजा जा सकता है, ताकि नतीजों का अगला पेज वापस पाया जा सके. अगर यह खाली है, तो इसके बाद कोई पेज नहीं है.

ListMembershipsRequest

सदस्यताओं को लिस्ट करने के लिए अनुरोध वाला मैसेज.

फ़ील्ड
parent

string

ज़रूरी है. उस स्पेस का संसाधन नाम जिसके लिए सदस्यता की सूची फ़ेच करनी है.

फ़ॉर्मैट: spaces/{space}

page_size

int32

ज़रूरी नहीं. पैसे चुकाकर ली गई ज़्यादा से ज़्यादा सदस्यताओं की संख्या. ऐसा हो सकता है कि सेवा इस वैल्यू से कम नतीजे दिखाए.

अगर इसे तय नहीं किया गया है, तो ज़्यादा से ज़्यादा 100 सदस्यताएं दिखाई जाती हैं.

इसकी ज़्यादा से ज़्यादा वैल्यू 1,000 हो सकती है. अगर 1,000 से ज़्यादा वैल्यू का इस्तेमाल किया जाता है, तो उसे अपने-आप 1,000 में बदल दिया जाता है.

नेगेटिव वैल्यू डालने पर, INVALID_ARGUMENT गड़बड़ी दिखती है.

page_token

string

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

पेज नंबर के हिसाब से नतीजे दिखाने के दौरान, दिए गए अन्य सभी पैरामीटर, पेज टोकन देने वाले कॉल से मेल खाने चाहिए. अन्य पैरामीटर को अलग-अलग वैल्यू पास करने से, अनचाहे नतीजे मिल सकते हैं.

filter

string

ज़रूरी नहीं. क्वेरी फ़िल्टर.

सदस्यों की भूमिका (role) और सदस्यता के टाइप (member.type) के हिसाब से, सदस्यताएं फ़िल्टर की जा सकती हैं.

भूमिका के हिसाब से फ़िल्टर करने के लिए, role को ROLE_MEMBER या ROLE_MANAGER पर सेट करें.

टाइप के हिसाब से फ़िल्टर करने के लिए, member.type को HUMAN या BOT पर सेट करें. != ऑपरेटर का इस्तेमाल करके, member.type के लिए भी फ़िल्टर किया जा सकता है.

रोल और टाइप, दोनों के हिसाब से फ़िल्टर करने के लिए, AND ऑपरेटर का इस्तेमाल करें. रोल या टाइप, दोनों में से किसी एक के हिसाब से फ़िल्टर करने के लिए, OR ऑपरेटर का इस्तेमाल करें.

use_admin_access को 'सही है' पर सेट करने पर, member.type = "HUMAN" या member.type != "BOT" में से किसी एक की वैल्यू देना ज़रूरी है. सदस्यता के अन्य टाइप के फ़िल्टर अस्वीकार कर दिए जाएंगे.

उदाहरण के लिए, ये क्वेरी मान्य हैं:

role = "ROLE_MANAGER" OR role = "ROLE_MEMBER"
member.type = "HUMAN" AND role = "ROLE_MANAGER"

member.type != "BOT"

ये क्वेरी अमान्य हैं:

member.type = "HUMAN" AND member.type = "BOT"
role = "ROLE_MANAGER" AND role = "ROLE_MEMBER"

अमान्य क्वेरी को सर्वर, INVALID_ARGUMENT गड़बड़ी के साथ अस्वीकार कर देता है.

show_groups

bool

ज़रूरी नहीं. true होने पर, यह Google Group से जुड़ी मेंबरशिप भी दिखाता है. इसके अलावा, यह अन्य तरह की मेंबरशिप भी दिखाता है. अगर filter सेट किया गया है, तो फ़िल्टर करने की शर्त से मेल न खाने वाली Google Group सदस्यताएं नहीं दिखाई जाती हैं.

show_invited

bool

ज़रूरी नहीं. true होने पर, यह अन्य तरह की मेंबरशिप के साथ-साथ, invited के सदस्यों से जुड़ी मेंबरशिप भी दिखाता है. अगर कोई फ़िल्टर सेट किया गया है, तो invited सदस्यताएं नहीं दिखेंगी. ऐसा इसलिए, क्योंकि वे फ़िल्टर के मानदंड से मेल नहीं खाती हैं.

फ़िलहाल, इसके लिए उपयोगकर्ता की पुष्टि करना ज़रूरी है.

use_admin_access

bool

ज़रूरी नहीं. जब true होता है, तो यह तरीका उपयोगकर्ता के Google Workspace एडमिन के अधिकारों का इस्तेमाल करके काम करता है.

कॉल करने वाला व्यक्ति, Google Workspace एडमिन होना चाहिए. साथ ही, उसके पास चैट और स्पेस में होने वाली बातचीत को मैनेज करने का अधिकार होना चाहिए.

इसके लिए, chat.admin.memberships.readonly या chat.admin.memberships OAuth 2.0 स्कोप की ज़रूरत होती है.

एडमिन ऐक्सेस का इस्तेमाल करने पर, किसी स्पेस में ऐप्लिकेशन की सदस्यताएं दिखाने की सुविधा काम नहीं करती.

ListMembershipsResponse

स्पेस की सदस्यताओं की सूची का जवाब.

फ़ील्ड
memberships[]

Membership

बिना क्रम वाली सूची. अनुरोध किए गए (या पहले) पेज पर मौजूद सदस्यताओं की सूची.

next_page_token

string

यह एक ऐसा टोकन है जिसे pageToken के तौर पर भेजा जा सकता है, ताकि नतीजों का अगला पेज वापस पाया जा सके. अगर यह खाली है, तो इसके बाद कोई पेज नहीं है.

ListMessagePinsRequest

मैसेज पिन की लिस्टिंग के लिए अनुरोध मैसेज.

फ़ील्ड
parent

string

ज़रूरी है. पैरंट स्पेस, जिसमें पिन किए गए आइटम का कलेक्शन होता है. फ़ॉर्मैट: spaces/{space}

page_size

int32

ज़रूरी नहीं. पिन किए गए ज़्यादा से ज़्यादा मैसेज दिखाए जाते हैं. ऐसा हो सकता है कि सेवा, इस वैल्यू से कम मैसेज दिखाए. ज़्यादा से ज़्यादा वैल्यू 100 हो सकती है. अगर 100 से ज़्यादा वैल्यू का इस्तेमाल किया जाता है, तो उसे अपने-आप 100 पर सेट कर दिया जाता है. अगर इसे तय नहीं किया गया है, तो ज़्यादा से ज़्यादा 100 मैसेज पिन किए जाएंगे. नेगेटिव वैल्यू डालने पर, INVALID_ARGUMENT गड़बड़ी दिखती है.

page_token

string

ज़रूरी नहीं. यह पेज टोकन, सूची वाले मैसेज को पिन करने के लिए इस्तेमाल किया जाता है. यह टोकन, सूची वाले मैसेज को पिन करने के लिए इस्तेमाल किया जाता है. अगला पेज पाने के लिए, यह पैरामीटर दें.

पेज नंबर के हिसाब से नतीजे दिखाने के दौरान, दिए गए अन्य सभी पैरामीटर, पेज टोकन देने वाले कॉल से मेल खाने चाहिए. अन्य पैरामीटर को अलग-अलग वैल्यू पास करने से, अनचाहे नतीजे मिल सकते हैं.

ListMessagePinsResponse

मैसेज पिन की सूची बनाने के लिए जवाब का मैसेज.

फ़ील्ड
message_pins[]

MessagePin

चुनिंदा स्पेस में पिन किए गए मैसेज.

next_page_token

string

नतीजों का अगला पेज पाने के लिए, pageToken के तौर पर टोकन भेजा जा सकता है. अगर यह खाली है, तो इसके बाद कोई पेज नहीं है.

ListMessagesRequest

यह स्पेस में मौजूद उन मैसेज की सूची दिखाता है जिनमें उपयोगकर्ता शामिल है.

फ़ील्ड
parent

string

ज़रूरी है. उस स्पेस का संसाधन नाम जिससे मैसेज की सूची बनानी है.

फ़ॉर्मैट: spaces/{space}

page_size

int32

ज़रूरी नहीं. ज़्यादा से ज़्यादा इतने मैसेज दिखाए जा सकते हैं. ऐसा हो सकता है कि सेवा, इस वैल्यू से कम मैसेज दिखाए.

अगर इसे तय नहीं किया गया है, तो ज़्यादा से ज़्यादा 25 नतीजे दिखते हैं.

इसकी ज़्यादा से ज़्यादा वैल्यू 1,000 हो सकती है. अगर 1,000 से ज़्यादा वैल्यू का इस्तेमाल किया जाता है, तो उसे अपने-आप 1,000 में बदल दिया जाता है.

नेगेटिव वैल्यू डालने पर, INVALID_ARGUMENT गड़बड़ी दिखती है.

page_token

string

ज़रूरी नहीं. यह एक पेज टोकन है, जो सूची में मौजूद मैसेज को कॉल करने के पिछले अनुरोध से मिला है. अगला पेज पाने के लिए, यह पैरामीटर दें.

पेज नंबर के हिसाब से नतीजे दिखाने के दौरान, दिए गए अन्य सभी पैरामीटर, पेज टोकन देने वाले कॉल से मेल खाने चाहिए. अन्य पैरामीटर को अलग-अलग वैल्यू पास करने से, अनचाहे नतीजे मिल सकते हैं.

filter

string

ज़रूरी नहीं. क्वेरी फ़िल्टर.

मैसेज को तारीख (create_time) और थ्रेड (thread.name) के हिसाब से फ़िल्टर किया जा सकता है.

मैसेज बनाए जाने की तारीख के हिसाब से उन्हें फ़िल्टर करने के लिए, create_time को RFC-3339 फ़ॉर्मैट में टाइमस्टैंप और दोहरे उद्धरण चिह्नों के साथ डालें. उदाहरण के लिए, "2023-04-21T11:30:00-04:00". टाइमस्टैंप के बाद बनाए गए मैसेज की सूची बनाने के लिए, ग्रेटर दैन ऑपरेटर > का इस्तेमाल करें. इसके अलावा, टाइमस्टैंप से पहले बनाए गए मैसेज की सूची बनाने के लिए, लेस दैन ऑपरेटर < का इस्तेमाल करें. किसी समयावधि के मैसेज फ़िल्टर करने के लिए, दो टाइमस्टैंप के बीच AND ऑपरेटर का इस्तेमाल करें.

थ्रेड के हिसाब से फ़िल्टर करने के लिए, thread.name को spaces/{space}/threads/{thread} के तौर पर फ़ॉर्मैट करें. हर क्वेरी के लिए, सिर्फ़ एक thread.name की जानकारी दी जा सकती है.

थ्रेड और तारीख, दोनों के हिसाब से फ़िल्टर करने के लिए, अपनी क्वेरी में AND ऑपरेटर का इस्तेमाल करें.

उदाहरण के लिए, ये क्वेरी मान्य हैं:

create_time > "2012-04-21T11:30:00-04:00"

create_time > "2012-04-21T11:30:00-04:00" AND
  thread.name = spaces/AAAAAAAAAAA/threads/123

create_time > "2012-04-21T11:30:00+00:00" AND

create_time < "2013-01-01T00:00:00+00:00" AND
  thread.name = spaces/AAAAAAAAAAA/threads/123

thread.name = spaces/AAAAAAAAAAA/threads/123

अमान्य क्वेरी को सर्वर, INVALID_ARGUMENT गड़बड़ी के साथ अस्वीकार कर देता है.

order_by

string

ज़रूरी नहीं. मैसेज की सूची को किस क्रम में लगाया गया है. क्रम से लगाने की कार्रवाई के लिए, कोई वैल्यू तय करें. ऑर्डर करने की कार्रवाई के लिए मान्य वैल्यू यहां दी गई हैं:

  • ASC का इस्तेमाल बढ़ते क्रम के लिए किया जाता है.

  • घटते क्रम के लिए, DESC.

डिफ़ॉल्ट क्रम create_time ASC है.

show_deleted

bool

ज़रूरी नहीं. मिटाए गए मैसेज शामिल करने हैं या नहीं. मिटाए गए मैसेज में, उन्हें मिटाने का समय और मिटाने से जुड़ा मेटाडेटा शामिल होता है. हालांकि, मैसेज का कॉन्टेंट उपलब्ध नहीं होता.

ListMessagesResponse

मैसेज की सूची बनाने के लिए जवाब का मैसेज.

फ़ील्ड
messages[]

Message

मैसेज की सूची.

next_page_token

string

नतीजों का अगला पेज पाने के लिए, pageToken के तौर पर टोकन भेजा जा सकता है. अगर यह खाली है, तो इसके बाद कोई पेज नहीं है.

ListReactionsRequest

किसी मैसेज पर की गई प्रतिक्रियाओं की सूची दिखाता है.

फ़ील्ड
parent

string

ज़रूरी है. वह मैसेज जिस पर उपयोगकर्ताओं ने प्रतिक्रिया दी.

फ़ॉर्मैट: spaces/{space}/messages/{message}

page_size

int32

ज़रूरी नहीं. ज़्यादा से ज़्यादा कितनी प्रतिक्रियाएं दिखाई जाएंगी. सेवा इस वैल्यू से कम रिएक्शन दिखा सकती है. अगर कोई वैल्यू तय नहीं की गई है, तो डिफ़ॉल्ट वैल्यू 25 होती है. ज़्यादा से ज़्यादा 200 वैल्यू डाली जा सकती हैं. 200 से ज़्यादा वैल्यू डालने पर, उन्हें 200 में बदल दिया जाता है.

page_token

string

ज़रूरी नहीं. (अगर पिछली क्वेरी से काम फिर से शुरू किया जा रहा है.)

यह पेज टोकन, प्रतिक्रियाओं की सूची के लिए किए गए पिछले कॉल से मिला है. अगला पेज पाने के लिए, यह जानकारी दें.

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

filter

string

ज़रूरी नहीं. क्वेरी फ़िल्टर.

प्रतिक्रियाओं को इमोजी (emoji.unicode या emoji.custom_emoji.uid) और उपयोगकर्ता (user.name) के हिसाब से फ़िल्टर किया जा सकता है.

एक से ज़्यादा इमोजी या उपयोगकर्ताओं के लिए प्रतिक्रियाओं को फ़िल्टर करने के लिए, एक जैसे फ़ील्ड को OR ऑपरेटर के साथ जोड़ें. जैसे, emoji.unicode = "🙂" OR emoji.unicode = "👍" और user.name = "users/AAAAAA" OR user.name = "users/BBBBBB".

इमोजी और उपयोगकर्ता के हिसाब से प्रतिक्रियाओं को फ़िल्टर करने के लिए, AND ऑपरेटर का इस्तेमाल करें. जैसे, emoji.unicode = "🙂" AND user.name = "users/AAAAAA".

अगर आपकी क्वेरी में AND और OR, दोनों का इस्तेमाल किया गया है, तो उन्हें ब्रैकेट में रखें.

उदाहरण के लिए, ये क्वेरी मान्य हैं:

user.name = "users/{user}"
emoji.unicode = "🙂"
emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" OR emoji.unicode = "👍"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" AND user.name = "users/{user}"
(emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}")
AND user.name = "users/{user}"

ये क्वेरी अमान्य हैं:

emoji.unicode = "🙂" AND emoji.unicode = "👍"
emoji.unicode = "🙂" AND emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" OR user.name = "users/{user}"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}" OR
user.name = "users/{user}"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}"
AND user.name = "users/{user}"

अमान्य क्वेरी को INVALID_ARGUMENT गड़बड़ी के साथ अस्वीकार कर दिया जाता है.

ListReactionsResponse

प्रतिक्रियाओं की सूची के अनुरोध का जवाब.

फ़ील्ड
reactions[]

Reaction

अनुरोध किए गए (या पहले) पेज पर मौजूद प्रतिक्रियाओं की सूची.

next_page_token

string

नतीजों के अगले पेज को वापस पाने के लिए, जारी रखने का टोकन. यह नतीजों के आखिरी पेज के लिए खाली होता है.

ListSectionItemsRequest

लिस्टिंग सेक्शन के आइटम के लिए अनुरोध मैसेज.

फ़ील्ड
parent

string

ज़रूरी है. पैरंट, जो सेक्शन के संसाधन का वह नाम होता है जिसके पास सेक्शन आइटम के इस कलेक्शन का मालिकाना हक होता है. यह सुविधा, कॉल करने वाले व्यक्ति के लिए सिर्फ़ लिस्टिंग सेक्शन के आइटम के साथ काम करती है.

जगह के हिसाब से फ़िल्टर करते समय, सभी सेक्शन में खोजने के लिए वाइल्डकार्ड - का इस्तेमाल करें. उदाहरण के लिए, users/{user}/sections/-.

फ़ॉर्मैट: users/{user}/sections/{section}

page_size

int32

ज़रूरी नहीं. सेक्शन के ज़्यादा से ज़्यादा आइटम वापस लाने की संख्या. ऐसा हो सकता है कि सेवा इस वैल्यू से कम नतीजे दिखाए.

अगर इसे तय नहीं किया गया है, तो ज़्यादा से ज़्यादा 10 सेक्शन आइटम दिखाए जाएंगे.

ज़्यादा से ज़्यादा वैल्यू 100 हो सकती है. अगर 100 से ज़्यादा वैल्यू का इस्तेमाल किया जाता है, तो उसे अपने-आप 100 पर सेट कर दिया जाता है.

नेगेटिव वैल्यू डालने पर, INVALID_ARGUMENT गड़बड़ी दिखती है.

page_token

string

ज़रूरी नहीं. यह पेज टोकन, सूची के सेक्शन में मौजूद आइटम को कॉल करने के पिछले अनुरोध से मिला है. अगला पेज पाने के लिए, यह जानकारी दें.

पेज नंबर के हिसाब से नतीजे दिखाने के दौरान, दिए गए अन्य सभी पैरामीटर, पेज टोकन देने वाले कॉल से मेल खाने चाहिए. अन्य पैरामीटर को अलग-अलग वैल्यू पास करने से, अनचाहे नतीजे मिल सकते हैं.

filter

string

ज़रूरी नहीं. क्वेरी फ़िल्टर.

फ़िलहाल, सिर्फ़ स्पेस के हिसाब से फ़िल्टर करने की सुविधा उपलब्ध है.

उदाहरण के लिए, space = spaces/{space}.

अमान्य क्वेरी को INVALID_ARGUMENT गड़बड़ी के साथ अस्वीकार कर दिया जाता है.

ListSectionItemsResponse

लिस्टिंग सेक्शन में मौजूद आइटम के लिए जवाब का मैसेज.

फ़ील्ड
section_items[]

SectionItem

चुने गए सेक्शन के आइटम.

next_page_token

string

यह एक टोकन है. इसे page_token के तौर पर भेजा जा सकता है, ताकि अगला पेज वापस पाया जा सके. अगर इस फ़ील्ड को शामिल नहीं किया जाता है, तो इसके बाद कोई पेज नहीं होता.

ListSectionsRequest

सूची बनाने वाले सेक्शन के लिए अनुरोध मैसेज.

फ़ील्ड
parent

string

ज़रूरी है. पैरंट, जो उपयोगकर्ता के संसाधन का वह नाम है जिसके पास सेक्शन के इस कलेक्शन का मालिकाना हक है. यह सिर्फ़ कॉल करने वाले व्यक्ति के लिए, लिस्टिंग सेक्शन दिखाता है. कॉल करने वाले उपयोगकर्ता को रेफ़र करने के लिए, इनमें से कोई एक विकल्प सेट करें:

  • me का दूसरा ईमेल पता. उदाहरण के लिए, users/me.

  • उनका Workspace ईमेल पता. उदाहरण के लिए, users/user@example.com.

  • उनका यूज़र आईडी. उदाहरण के लिए, users/123456789.

फ़ॉर्मैट: users/{user}

page_size

int32

ज़रूरी नहीं. ज़्यादा से ज़्यादा कितने सेक्शन वापस लाने हैं. ऐसा हो सकता है कि सेवा इस वैल्यू से कम नतीजे दिखाए.

अगर इसे तय नहीं किया गया है, तो ज़्यादा से ज़्यादा 10 सेक्शन दिखाए जाएंगे.

ज़्यादा से ज़्यादा वैल्यू 100 हो सकती है. अगर 100 से ज़्यादा वैल्यू का इस्तेमाल किया जाता है, तो उसे अपने-आप 100 पर सेट कर दिया जाता है.

नेगेटिव वैल्यू डालने पर, INVALID_ARGUMENT गड़बड़ी दिखती है.

page_token

string

ज़रूरी नहीं. यह पेज टोकन है. यह सूची सेक्शन को कॉल करने के पिछले अनुरोध के जवाब में मिला था. अगला पेज पाने के लिए, यह जानकारी दें.

पेज नंबर के हिसाब से नतीजे दिखाने के दौरान, दिए गए अन्य सभी पैरामीटर, पेज टोकन देने वाले कॉल से मेल खाने चाहिए. अन्य पैरामीटर को अलग-अलग वैल्यू पास करने से, अनचाहे नतीजे मिल सकते हैं.

ListSectionsResponse

लिस्टिंग सेक्शन के लिए जवाब का मैसेज.

फ़ील्ड
sections[]

Section

चुने गए उपयोगकर्ता के सेक्शन.

next_page_token

string

यह एक टोकन है. इसे page_token के तौर पर भेजा जा सकता है, ताकि अगला पेज वापस पाया जा सके. अगर इस फ़ील्ड को शामिल नहीं किया जाता है, तो इसके बाद कोई पेज नहीं होता.

ListSpaceEventsRequest

स्पेस इवेंट की सूची बनाने के लिए अनुरोध किया गया मैसेज.

फ़ील्ड
parent

string

ज़रूरी है. उस Google Chat स्पेस का रिसॉर्स नाम जहां इवेंट हुए.

फ़ॉर्मैट: spaces/{space}.

page_size

int32

ज़रूरी नहीं. स्पेस इवेंट की ज़्यादा से ज़्यादा संख्या दिखाई गई है. ऐसा हो सकता है कि सेवा इस वैल्यू से कम नतीजे दिखाए.

नेगेटिव वैल्यू डालने पर, INVALID_ARGUMENT गड़बड़ी दिखती है.

page_token

string

ज़रूरी नहीं. यह पेज टोकन, स्पेस इवेंट की सूची पाने के लिए किए गए पिछले कॉल से मिला है. अगला पेज पाने के लिए, यह जानकारी दें.

पेज नंबर के हिसाब से नतीजे दिखाने के दौरान, सूची के स्पेस इवेंट के लिए दिए गए सभी अन्य पैरामीटर, पेज टोकन देने वाले कॉल से मेल खाने चाहिए. अन्य पैरामीटर के लिए अलग-अलग वैल्यू पास करने से, अनचाहे नतीजे मिल सकते हैं.

filter

string

ज़रूरी है. क्वेरी फ़िल्टर.

आपको has : ऑपरेटर का इस्तेमाल करके, कम से कम एक इवेंट टाइप (event_type) तय करना होगा. एक से ज़्यादा इवेंट टाइप के हिसाब से फ़िल्टर करने के लिए, OR ऑपरेटर का इस्तेमाल करें. अपने फ़िल्टर में बैच इवेंट टाइप शामिल न करें. अनुरोध करने पर, सर्वर अपने-आप बैच इवेंट से जुड़े सभी इवेंट दिखाएगा. उदाहरण के लिए, अगर आपने नई प्रतिक्रियाओं (google.workspace.chat.reaction.v1.created) के हिसाब से फ़िल्टर किया है, तो सर्वर बैच नई प्रतिक्रियाओं वाले इवेंट (google.workspace.chat.reaction.v1.batchCreated) भी दिखाएगा. साथ ही, SpaceEvents रेफ़रंस दस्तावेज़ में जाकर, इस्तेमाल किए जा सकने वाले इवेंट टाइप की सूची देखें.

इसके अलावा, शुरू होने के समय (start_time) और खत्म होने के समय (end_time) के हिसाब से भी फ़िल्टर किया जा सकता है:

  • start_time: यह एक खास टाइमस्टैंप है. इससे स्पेस इवेंट की सूची बनाना शुरू किया जा सकता है. ऐसे इवेंट की सूची बनाई जा सकती है जो 28 दिन पहले हुए थे. अगर यह टाइमस्टैंप नहीं दिया जाता है, तो पिछले 28 दिनों में हुए स्पेस इवेंट की सूची बनाई जाती है.
  • end_time: यह टाइमस्टैंप, स्पेस के इवेंट की सूची में शामिल किया जाता है. अगर इसे तय नहीं किया जाता है, तो अनुरोध के समय तक के इवेंट की सूची दिखती है.

शुरू या खत्म होने का समय तय करने के लिए, बराबर = ऑपरेटर का इस्तेमाल करें. साथ ही, RFC-3339 फ़ॉर्मैट में समय डालें. start_time और end_time, दोनों के हिसाब से फ़िल्टर करने के लिए, AND ऑपरेटर का इस्तेमाल करें.

उदाहरण के लिए, ये क्वेरी मान्य हैं:

start_time="2023-08-23T19:20:33+00:00" AND
end_time="2023-08-23T19:21:54+00:00"
start_time="2023-08-23T19:20:33+00:00" AND
(event_types:"google.workspace.chat.space.v1.updated" OR
event_types:"google.workspace.chat.message.v1.created")

ये क्वेरी अमान्य हैं:

start_time="2023-08-23T19:20:33+00:00" OR
end_time="2023-08-23T19:21:54+00:00"
event_types:"google.workspace.chat.space.v1.updated" AND
event_types:"google.workspace.chat.message.v1.created"

अमान्य क्वेरी को सर्वर, INVALID_ARGUMENT गड़बड़ी के साथ अस्वीकार कर देता है.

ListSpaceEventsResponse

स्पेस इवेंट की सूची बनाने के लिए जवाब का मैसेज.

फ़ील्ड
space_events[]

SpaceEvent

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

next_page_token

string

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

ListSpacesRequest

कॉल करने वाले व्यक्ति के उन स्पेस की सूची दिखाने का अनुरोध जिनमें वह सदस्य है.

फ़ील्ड
page_size

int32

ज़रूरी नहीं. ज़्यादा से ज़्यादा कितने स्पेस दिखाने हैं. ऐसा हो सकता है कि सेवा इस वैल्यू से कम नतीजे दिखाए.

अगर यह तय नहीं किया गया है, तो ज़्यादा से ज़्यादा 100 स्पेस दिखाए जाते हैं.

इसकी ज़्यादा से ज़्यादा वैल्यू 1,000 हो सकती है. अगर 1,000 से ज़्यादा वैल्यू का इस्तेमाल किया जाता है, तो उसे अपने-आप 1,000 में बदल दिया जाता है.

नेगेटिव वैल्यू डालने पर, INVALID_ARGUMENT गड़बड़ी दिखती है.

page_token

string

ज़रूरी नहीं. यह एक पेज टोकन है. यह पिछली बार list spaces को कॉल करने पर मिला था. अगला पेज पाने के लिए, यह पैरामीटर दें.

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

filter

string

ज़रूरी नहीं. क्वेरी फ़िल्टर.

स्पेस के टाइप (space_type) के हिसाब से स्पेस फ़िल्टर किए जा सकते हैं.

स्पेस टाइप के हिसाब से फ़िल्टर करने के लिए, आपको मान्य enum वैल्यू तय करनी होगी. जैसे, SPACE या GROUP_CHAT (space_type, SPACE_TYPE_UNSPECIFIED नहीं हो सकता). एक से ज़्यादा स्पेस टाइप के लिए क्वेरी करने के लिए, OR ऑपरेटर का इस्तेमाल करें.

उदाहरण के लिए, ये क्वेरी मान्य हैं:

space_type = "SPACE"
spaceType = "GROUP_CHAT" OR spaceType = "DIRECT_MESSAGE"

अमान्य क्वेरी को सर्वर, INVALID_ARGUMENT गड़बड़ी के साथ अस्वीकार कर देता है.

ListSpacesResponse

स्पेस की सूची के अनुरोध का जवाब.

फ़ील्ड
spaces[]

Space

अनुरोध किए गए (या पहले) पेज में मौजूद स्पेस की सूची. ध्यान दें: सूची के अनुरोधों के लिए, Space ऑब्जेक्ट में permissionSettings फ़ील्ड नहीं दिखाया जाता.

next_page_token

string

नतीजों का अगला पेज पाने के लिए, pageToken के तौर पर टोकन भेजा जा सकता है. अगर यह खाली है, तो इसका मतलब है कि इसके बाद कोई पेज नहीं है.

MatchedUrl

Chat मैसेज में मौजूद ऐसा यूआरएल जो किसी पैटर्न से मेल खाता हो. Chat ऐप्लिकेशन, मेल खाने वाले यूआरएल की झलक देख सकते हैं. ज़्यादा जानकारी के लिए, लिंक की झलक देखना लेख पढ़ें.

फ़ील्ड
url

string

सिर्फ़ आउटपुट के लिए. वह यूआरएल जिससे मैच किया गया है.

MeetSpaceLinkData

मीटिंग स्पेस के लिंक का डेटा.

फ़ील्ड
meeting_code

string

लिंक किए गए Meet स्पेस का मीटिंग कोड.

type

Type

इससे Meet स्पेस का टाइप पता चलता है.

huddle_status

HuddleStatus

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

HuddleStatus

हडल का स्टेटस

Enums
HUDDLE_STATUS_UNSPECIFIED इनम की डिफ़ॉल्ट वैल्यू. इसका इस्तेमाल न करें.
STARTED हडल कॉल शुरू हो गया है.
ENDED हडल खत्म हो गया है. इस मामले में, Meet स्पेस का यूआरआई और आइडेंटिफ़ायर अब मान्य नहीं रहेंगे.
MISSED हडल में शामिल होने का न्योता नहीं मिला. इस मामले में, Meet स्पेस का यूआरआई और आइडेंटिफ़ायर मान्य नहीं रहेंगे.

टाइप

मीटिंग स्पेस का टाइप.

Enums
TYPE_UNSPECIFIED इनम की डिफ़ॉल्ट वैल्यू. इसका इस्तेमाल न करें.
MEETING मीटिंग स्पेस एक मीटिंग है.
HUDDLE मीटिंग स्पेस एक हडल है.

सदस्यता

यह Google Chat में सदस्यता के बारे में जानकारी देता है. जैसे, किसी उपयोगकर्ता या Chat ऐप्लिकेशन को किसी स्पेस में शामिल होने का न्योता मिला है, वह स्पेस का हिस्सा है या स्पेस में मौजूद नहीं है.

फ़ील्ड
name

string

पहचान करने वाला. सदस्यता के संसाधन का नाम, जिसे सर्वर असाइन करता है.

फ़ॉर्मैट: spaces/{space}/members/{member}

state

MembershipState

सिर्फ़ आउटपुट के लिए. पैसे चुकाकर ली जाने वाली सदस्यता की स्थिति.

role

MembershipRole

ज़रूरी नहीं. Chat स्पेस में उपयोगकर्ता की भूमिका. इससे यह तय होता है कि उपयोगकर्ता स्पेस में कौनसी कार्रवाइयां कर सकता है.

इस फ़ील्ड का इस्तेमाल सिर्फ़ UpdateMembership में इनपुट के तौर पर किया जा सकता है.

create_time

Timestamp

ज़रूरी नहीं. इम्यूटेबल. सदस्यता बनाने का समय. जैसे, कोई सदस्य किसी स्पेस में कब शामिल हुआ या उसे कब शामिल होने का न्योता मिला. यह फ़ील्ड सिर्फ़ आउटपुट के लिए होता है. हालांकि, इसका इस्तेमाल इंपोर्ट मोड वाले स्पेस में, सदस्यता का पुराना डेटा इंपोर्ट करने के लिए किया जा सकता है.

delete_time

Timestamp

ज़रूरी नहीं. इम्यूटेबल. सदस्यता मिटाने का समय. जैसे, जब कोई सदस्य किसी स्पेस को छोड़ता है या उसे स्पेस से हटाया जाता है. यह फ़ील्ड सिर्फ़ आउटपुट के लिए होता है. हालांकि, इसका इस्तेमाल इंपोर्ट मोड वाले स्पेस में, सदस्यता का पुराना डेटा इंपोर्ट करने के लिए किया जा सकता है.

यूनियन फ़ील्ड memberType. इस सदस्यता से जुड़ा सदस्य. आने वाले समय में, अन्य तरह के सदस्यों के लिए भी यह सुविधा उपलब्ध हो सकती है. memberType इनमें से सिर्फ़ एक हो सकता है:
member

User

ज़रूरी नहीं. Google Chat का वह उपयोगकर्ता या ऐप्लिकेशन जिसकी सदस्यता है. अगर आपका Chat ऐप्लिकेशन, उपयोगकर्ता के तौर पर पुष्टि करता है, तो आउटपुट, उपयोगकर्ता name और type को भरता है.

group_member

Group

ज़रूरी नहीं. Google ग्रुप, जिससे सदस्यता जुड़ी है.

Google Groups के लिए, सदस्यताएं पढ़ने या उनमें बदलाव करने के लिए उपयोगकर्ता की पुष्टि करना ज़रूरी है.

MembershipRole

इससे पता चलता है कि कोई उपयोगकर्ता, Chat स्पेस में कौनसी कार्रवाइयां कर सकता है. आने वाले समय में, इसमें और एनम वैल्यू जोड़ी जा सकती हैं.

Enums
MEMBERSHIP_ROLE_UNSPECIFIED डिफ़ॉल्ट मान. users के लिए: वे स्पेस के सदस्य नहीं हैं, लेकिन उन्हें न्योता भेजा जा सकता है. Google Groups के लिए: उन्हें हमेशा यह भूमिका असाइन की जाती है. हालांकि, आने वाले समय में अन्य enum वैल्यू का इस्तेमाल किया जा सकता है.
ROLE_MEMBER

स्पेस का सदस्य. Chat के यूज़र इंटरफ़ेस (यूआई) में, इस भूमिका को सदस्य कहा जाता है.

उपयोगकर्ता के पास बुनियादी अनुमतियां होती हैं. जैसे, स्पेस में मैसेज भेजना. मैनेजर और मालिक, सदस्यों को स्पेस में अतिरिक्त अनुमतियां दे सकते हैं. जैसे:

  • सदस्यों को जोड़ना या हटाना.
  • स्पेस की जानकारी में बदलाव करना.
  • इतिहास को चालू या बंद करें.
  • @all का इस्तेमाल करके, स्पेस के सभी सदस्यों का नाम टैग करें.
  • स्पेस में इंस्टॉल किए गए Chat ऐप्लिकेशन और वेबुक मैनेज करें.

डायरेक्ट मैसेज और बिना नाम वाली ग्रुप बातचीत में, सभी के पास यह भूमिका होती है.

ROLE_MANAGER

स्पेस का मालिक. Chat के यूज़र इंटरफ़ेस (यूआई) में, इस भूमिका को मालिक कहा जाता है.

उपयोगकर्ता के पास स्पेस को मैनेज करने के लिए, स्पेस से जुड़ी सभी अनुमतियां होनी चाहिए. जैसे:

  • स्पेस में मौजूद अन्य सदस्यों की भूमिका को सदस्य, मैनेजर या मालिक के तौर पर बदलना.
  • स्पेस मिटाएं.

यह सुविधा सिर्फ़ SpaceType.SPACE (नाम वाली जगहें) में काम करती है.

ज़्यादा जानने के लिए, स्पेस के मालिक या मैनेजर की भूमिका के बारे में ज़्यादा जानें लेख पढ़ें.

ROLE_ASSISTANT_MANAGER

स्पेस मैनेजर. Chat के यूज़र इंटरफ़ेस (यूआई) में, इस भूमिका को मैनेजर कहा जाता है.

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

  • स्पेस मिटाएं.
  • स्पेस के किसी दूसरे सदस्य को मालिक बनाना.
  • मालिक की भूमिका बदलना.

डिफ़ॉल्ट रूप से, मैनेजर के पास ये अनुमतियां होती हैं. हालांकि, इनके अलावा और भी अनुमतियां हो सकती हैं:

  • किसी दूसरे सदस्य को मैनेजर बनाएं.
  • स्पेस में मौजूद मैसेज मिटाना.
  • स्पेस की अनुमतियां मैनेज करना.
  • अगर मैनेजर के पास स्पेस की सेटिंग में "सदस्यों को मैनेज करें" अनुमति है, तो उसे स्पेस में शामिल होने के अनुरोधों की सूचनाएं मिलती हैं.
  • स्पेस को सभी सदस्यों के लिए उपलब्ध कराएं.

यह सुविधा सिर्फ़ SpaceType.SPACE (नाम वाली जगहें) में काम करती है.

ज़्यादा जानने के लिए, स्पेस की सेटिंग मैनेज करना लेख पढ़ें.

MembershipState

इससे स्पेस में सदस्य की भूमिका के बारे में पता चलता है. आने वाले समय में, सदस्यता की अन्य स्थितियां भी जोड़ी जा सकती हैं.

Enums
MEMBERSHIP_STATE_UNSPECIFIED डिफ़ॉल्ट मान. इसका इस्तेमाल न करें.
JOINED उपयोगकर्ता को स्पेस में शामिल कर दिया जाता है. इसके बाद, वह स्पेस में हिस्सा ले सकता है.
INVITED उपयोगकर्ता को स्पेस में शामिल होने का न्योता भेजा गया है, लेकिन वह अब तक शामिल नहीं हुआ है.
NOT_A_MEMBER उपयोगकर्ता, स्पेस का सदस्य नहीं है. साथ ही, उसे स्पेस में शामिल होने का न्योता नहीं मिला है.

MembershipBatchCreatedEventData

एक से ज़्यादा नई सदस्यताओं के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.membership.v1.batchCreated

फ़ील्ड
memberships[]

MembershipCreatedEventData

पैसे चुकाकर ली गई नई सदस्यताओं की सूची.

MembershipBatchDeletedEventData

मिटाई गई एक से ज़्यादा सदस्यताओं के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.membership.v1.batchDeleted

फ़ील्ड
memberships[]

MembershipDeletedEventData

हटाए गए सदस्यों की सूची.

MembershipBatchUpdatedEventData

अपडेट की गई एक से ज़्यादा सदस्यताओं के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.membership.v1.batchUpdated

फ़ील्ड
memberships[]

MembershipUpdatedEventData

अपडेट की गई सदस्यताओं की सूची.

MembershipCreatedEventData

नई सदस्यता के लिए इवेंट पेलोड.

इवेंट टाइप: google.workspace.chat.membership.v1.created.

फ़ील्ड
membership

Membership

नई सदस्यता.

MembershipDeletedEventData

मिटाई गई सदस्यता के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.membership.v1.deleted

फ़ील्ड
membership

Membership

मिटाई गई सदस्यता. सिर्फ़ name और state फ़ील्ड में जानकारी अपने-आप भर जाती है.

MembershipUpdatedEventData

अपडेट की गई सदस्यता के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.membership.v1.updated

फ़ील्ड
membership

Membership

अपडेट की गई सदस्यता.

मैसेज

Google Chat स्पेस में मौजूद कोई मैसेज.

फ़ील्ड
name

string

आइडेंटिफ़ायर. मैसेज के संसाधन का नाम.

फ़ॉर्मैट: spaces/{space}/messages/{message}

यहां {space}, उस स्पेस का आईडी है जहां मैसेज पोस्ट किया गया है. साथ ही, {message}, सिस्टम की ओर से असाइन किया गया मैसेज आईडी है. उदाहरण के लिए, spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB.

अगर मैसेज बनाते समय कस्टम आईडी सेट किया जाता है, तो इस आईडी का इस्तेमाल करके अनुरोध में मैसेज के बारे में बताया जा सकता है. इसके लिए, clientAssignedMessageId फ़ील्ड की वैल्यू को {message} से बदलें. उदाहरण के लिए, spaces/AAAAAAAAAAA/messages/client-custom-name. ज़्यादा जानकारी के लिए, मैसेज का नाम देना लेख पढ़ें.

sender

User

सिर्फ़ आउटपुट. मैसेज बनाने वाला उपयोगकर्ता. अगर आपका Chat ऐप्लिकेशन उपयोगकर्ता के तौर पर पुष्टि करता है, तो आउटपुट में user name और type की जानकारी दिखती है.

create_time

Timestamp

ज़रूरी नहीं. इम्यूटेबल. Chat में बनाए गए स्पेस के लिए, मैसेज बनाने का समय. यह फ़ील्ड सिर्फ़ आउटपुट के लिए होता है. हालांकि, इसका इस्तेमाल इंपोर्ट मोड वाले स्पेस में किया जा सकता है.

इंपोर्ट मोड वाले स्पेस के लिए, इस फ़ील्ड को उस पुराने टाइमस्टैंप पर सेट करें जिस पर सोर्स में मैसेज बनाया गया था, ताकि मैसेज बनाने का मूल समय सुरक्षित रखा जा सके.

last_update_time

Timestamp

सिर्फ़ आउटपुट के लिए. वह समय जब किसी उपयोगकर्ता ने मैसेज में आखिरी बार बदलाव किया था. अगर मैसेज में कभी बदलाव नहीं किया गया है, तो यह फ़ील्ड खाली होता है.

delete_time

Timestamp

सिर्फ़ आउटपुट. यह वह समय है जब Google Chat में मैसेज मिटाया गया था. अगर मैसेज कभी नहीं मिटाया जाता है, तो यह फ़ील्ड खाली होता है.

text

string

ज़रूरी नहीं. मैसेज का मुख्य हिस्सा, सादे टेक्स्ट में. किसी इमेज, वीडियो या वेब पेज के पहले लिंक से झलक वाला चिप जनरेट होता है. आपके पास Google Chat के किसी उपयोगकर्ता या स्पेस में मौजूद सभी लोगों को@mention करने का विकल्प भी होता है.

टेक्स्ट मैसेज बनाने के बारे में जानने के लिए, मैसेज भेजना लेख पढ़ें.

formatted_text

string

सिर्फ़ आउटपुट. इसमें text का मैसेज होता है. इसमें फ़ॉर्मैटिंग की जानकारी देने के लिए मार्कअप जोड़े जाते हैं. ऐसा हो सकता है कि यह फ़ील्ड, यूज़र इंटरफ़ेस (यूआई) में दिखने वाली सभी फ़ॉर्मैटिंग को कैप्चर न करे. हालांकि, इसमें ये शामिल हैं:

  • बोल्ड, इटैलिक, स्ट्राइकथ्रू, मोनोस्पेस, मोनोस्पेस ब्लॉक, बुलेट वाली सूची, और ब्लॉक कोट के लिए मार्कअप सिंटैक्स.

  • <users/{user}> फ़ॉर्मैट का इस्तेमाल करके, उपयोगकर्ता के नाम टैग करना.

  • <{url}|{rendered_text}> फ़ॉर्मैट का इस्तेमाल करके बनाए गए कस्टम हाइपरलिंक. इसमें पहली स्ट्रिंग यूआरएल होती है और दूसरी स्ट्रिंग रेंडर किया गया टेक्स्ट होता है. उदाहरण के लिए, <http://example.com|custom text>.

  • :{emoji_name}: फ़ॉर्मैट का इस्तेमाल करके बनाया गया कस्टम इमोजी. उदाहरण के लिए, :smile:. यह यूनिकोड इमोजी पर लागू नहीं होता. जैसे, मुस्कुराते हुए चेहरे वाले इमोजी के लिए U+1F600.

  • तारे के निशान (*) का इस्तेमाल करके, बुलेट वाली सूची के आइटम—उदाहरण के लिए, * item.

ज़्यादा जानकारी के लिए, किसी मैसेज में भेजी गई टेक्स्ट फ़ॉर्मैटिंग देखना लेख पढ़ें

cards[]
(deprecated)

Card

इस्तेमाल बंद कर दिया गया है: इसके बजाय, cards_v2 का इस्तेमाल करें.

रिच, फ़ॉर्मैट किए गए, और इंटरैक्टिव कार्ड. इनका इस्तेमाल, यूज़र इंटरफ़ेस (यूआई) एलिमेंट दिखाने के लिए किया जा सकता है. जैसे: फ़ॉर्मैट किए गए टेक्स्ट, बटन, और क्लिक की जा सकने वाली इमेज. कार्ड आम तौर पर, मैसेज के सादे टेक्स्ट वाले मुख्य हिस्से के नीचे दिखाए जाते हैं. cards और cards_v2 का ज़्यादा से ज़्यादा साइज़ 32 केबी हो सकता है.

cards_v2[]

CardWithId

ज़रूरी नहीं. कार्ड का ऐरे.

चैट ऐप्लिकेशन, ऐप्लिकेशन की पुष्टि की सुविधा वाले कार्ड बना सकते हैं. डेवलपर प्रीव्यू प्रोग्राम के तहत, अगर आपका Chat ऐप्लिकेशन उपयोगकर्ता के तौर पर पुष्टि करता है, तो वह कार्ड मैसेज बना सकता है. अगर आपका Chat ऐप्लिकेशन, Developer Preview Program का हिस्सा नहीं है, तो वह उपयोगकर्ता की पुष्टि करने वाले कार्ड नहीं बना सकता.

कार्ड वाला मैसेज बनाने का तरीका जानने के लिए, मैसेज भेजना लेख पढ़ें.

कार्ड बिल्डर की मदद से, कार्ड डिज़ाइन करें और उनकी झलक देखें.

कार्ड बिल्डर खोलें

annotations[]

Annotation

सिर्फ़ आउटपुट. एनोटेशन को मैसेज के सादे टेक्स्ट वाले हिस्से या Google Workspace के संसाधनों से लिंक करने वाले चिप के साथ जोड़ा जा सकता है. जैसे, Google Docs या Sheets के साथ start_index और length का 0.

thread

Thread

वह थ्रेड जिससे मैसेज जुड़ा है. इसे इस्तेमाल करने के तरीके के बारे में जानने के लिए, मैसेज थ्रेड शुरू करना या उसका जवाब देना लेख पढ़ें.

space

Space

सिर्फ़ आउटपुट. अगर आपका Chat ऐप्लिकेशन, उपयोगकर्ता के तौर पर पुष्टि करता है, तो आउटपुट में सिर्फ़ स्पेस name की जानकारी दिखती है.

fallback_text

string

ज़रूरी नहीं. मैसेज के कार्ड का सामान्य टेक्स्ट वाला ब्यौरा. इसका इस्तेमाल तब किया जाता है, जब असली कार्ड नहीं दिखाए जा सकते. उदाहरण के लिए, मोबाइल सूचनाएं.

action_response

ActionResponse

सिर्फ़ इनपुट के लिए. ऐसे पैरामीटर जिनका इस्तेमाल करके, Chat ऐप्लिकेशन यह कॉन्फ़िगर कर सकता है कि उसके जवाब को कैसे पोस्ट किया जाए.

argument_text

string

सिर्फ़ आउटपुट के लिए. मैसेज का मुख्य हिस्सा, सादे टेक्स्ट में होता है. इसमें Chat ऐप्लिकेशन के सभी मेंशन हटा दिए जाते हैं.

slash_command

SlashCommand

सिर्फ़ आउटपुट के लिए. अगर लागू हो, तो स्लैश कमांड के बारे में जानकारी.

attachment[]

Attachment

ज़रूरी नहीं. उपयोगकर्ता का अपलोड किया गया अटैचमेंट.

matched_url

MatchedUrl

सिर्फ़ आउटपुट के लिए. Chat मैसेज के text फ़ील्ड में मौजूद ऐसा यूआरएल जो लिंक की झलक के पैटर्न से मेल खाता हो. ज़्यादा जानकारी के लिए, लिंक की झलक देखना लेख पढ़ें.

thread_reply

bool

सिर्फ़ आउटपुट के लिए. जब true होता है, तो इसका मतलब है कि मैसेज, जवाब वाले थ्रेड में मौजूद है. जब false होता है, तो मैसेज स्पेस की टॉप-लेवल बातचीत में दिखता है. यह थ्रेड का पहला मैसेज या थ्रेड में जवाब न दिया गया मैसेज होता है.

अगर स्पेस में थ्रेड में जवाब देने की सुविधा काम नहीं करती है, तो यह फ़ील्ड हमेशा false होता है.

silent

bool

सिर्फ़ आउटपुट. क्या यह साइलेंट मैसेज है. साइलेंट मैसेज ऐसे मैसेज होते हैं जिनमें Chat, मैसेज पाने वालों के लिए पुश नोटिफ़िकेशन को बंद कर देता है.

client_assigned_message_id

string

ज़रूरी नहीं. मैसेज के लिए कस्टम आईडी. इस फ़ील्ड का इस्तेमाल, किसी मैसेज की पहचान करने या उसे पाने, मिटाने या अपडेट करने के लिए किया जा सकता है. कस्टम आईडी सेट करने के लिए, मैसेज बनाते समय messageId फ़ील्ड की वैल्यू तय करें. ज़्यादा जानकारी के लिए, किसी मैसेज को नाम देना लेख पढ़ें.

emoji_reaction_summaries[]

EmojiReactionSummary

सिर्फ़ आउटपुट के लिए. मैसेज पर, इमोजी से दी गई प्रतिक्रियाओं की खास जानकारी की सूची.

private_message_viewer

User

ज़रूरी नहीं. इम्यूटेबल. मैसेज बनाने के लिए इनपुट दें. ऐसा न करने पर, सिर्फ़ आउटपुट मिलेगा. वह उपयोगकर्ता जो मैसेज देख सकता है. इस फ़ील्ड को सेट करने पर, मैसेज को निजी के तौर पर मार्क किया जाता है. यह सिर्फ़ उस उपयोगकर्ता और Chat ऐप्लिकेशन को दिखता है जिसे आपने चुना है. इस फ़ील्ड को अपने अनुरोध में शामिल करने के लिए, आपको ऐप्लिकेशन की पुष्टि का इस्तेमाल करके Chat API को कॉल करना होगा. साथ ही, आपको यहां दी गई जानकारी को शामिल नहीं करना होगा:

ज़्यादा जानकारी के लिए, निजी तौर पर मैसेज भेजना लेख पढ़ें.

deletion_metadata

DeletionMetadata

सिर्फ़ आउटपुट. मिटाए गए मैसेज के बारे में जानकारी. किसी मैसेज को तब मिटाया जाता है, जब delete_time सेट किया जाता है.

quoted_message_metadata

QuotedMessageMetadata

ज़रूरी नहीं. किसी ऐसे मैसेज के बारे में जानकारी जिसमें किसी दूसरे मैसेज का कोटेशन शामिल हो.

मैसेज बनाते समय, उसी थ्रेड में मौजूद मैसेज को कोट किया जा सकता है. इसके अलावा, नया रूट मैसेज बनाने के लिए, रूट मैसेज को कोट किया जा सकता है. हालांकि, किसी दूसरी थ्रेड के मैसेज के जवाब को कोट नहीं किया जा सकता.

मैसेज अपडेट करते समय, quotedMessageMetadata फ़ील्ड को जोड़ा या बदला नहीं जा सकता. हालांकि, इसे हटाया जा सकता है.

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

attached_gifs[]

AttachedGif

सिर्फ़ आउटपुट के लिए. मैसेज में अटैच की गई GIF इमेज.

accessory_widgets[]

AccessoryWidget

ज़रूरी नहीं. एक या उससे ज़्यादा इंटरैक्टिव विजेट, जो मैसेज के सबसे नीचे दिखते हैं. आपके पास ऐसे मैसेज में ऐक्सेसरी विजेट जोड़ने का विकल्प होता है जिनमें टेक्स्ट, कार्ड या टेक्स्ट और कार्ड, दोनों शामिल हों. डायलॉग वाले मैसेज के लिए यह सुविधा काम नहीं करती. ज़्यादा जानकारी के लिए, मैसेज के सबसे नीचे इंटरैक्टिव विजेट जोड़ना लेख पढ़ें.

ऐक्सेसरी विजेट के साथ मैसेज बनाने के लिए, ऐप्लिकेशन की पुष्टि करना ज़रूरी है.

MessageBatchCreatedEventData

एक से ज़्यादा नए मैसेज के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.message.v1.batchCreated

फ़ील्ड
messages[]

MessageCreatedEventData

नए मैसेज की सूची.

MessageBatchDeletedEventData

मिटाए गए कई मैसेज के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.message.v1.batchDeleted

फ़ील्ड
messages[]

MessageDeletedEventData

मिटाए गए मैसेज की सूची.

MessageBatchUpdatedEventData

अपडेट किए गए कई मैसेज के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.message.v1.batchUpdated

फ़ील्ड
messages[]

MessageUpdatedEventData

अपडेट किए गए मैसेज की सूची.

MessageCreatedEventData

नए मैसेज के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.message.v1.created

फ़ील्ड
message

Message

नया मैसेज.

MessageDeletedEventData

मिटाए गए मैसेज के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.message.v1.deleted

फ़ील्ड
message

Message

मिटाया गया मैसेज. सिर्फ़ name, createTime, और deletionMetadata फ़ील्ड में वैल्यू भरी जाती हैं.

MessagePin

Chat मैसेज पर पिन किया गया. ज़्यादा जानकारी के लिए, मैसेज पिन करना लेख पढ़ें.

फ़ील्ड
name

string

आइडेंटिफ़ायर. मैसेज पिन करने की सुविधा के संसाधन का नाम. फ़ॉर्मैट: spaces/{space}/messagePins/{message_pin} रिसॉर्स आईडी कॉम्पोनेंट, मैसेज के रिसॉर्स आईडी कॉम्पोनेंट से मेल खाता है. उदाहरण के लिए, spaces/AAA/messages/bbb.ccc वाला मैसेज, spaces/AAA/messagePins/bbb.ccc वाले संसाधन के नाम के साथ पिन किए गए मैसेज से मेल खाता है.

message

string

ज़रूरी है. इम्यूटेबल. पिन किए गए मैसेज का संसाधन नाम. फ़ॉर्मैट: spaces/{space}/messages/{message}

MessageUpdatedEventData

अपडेट किए गए मैसेज के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.message.v1.updated

फ़ील्ड
message

Message

अपडेट किया गया मैसेज.

MoveSectionItemRequest

सेक्शन के किसी आइटम को एक सेक्शन से दूसरे सेक्शन में ले जाने के लिए अनुरोध मैसेज.

फ़ील्ड
name

string

ज़रूरी है. जिस सेक्शन आइटम को दूसरी जगह ले जाना है उसका संसाधन नाम.

फ़ॉर्मैट: users/{user}/sections/{section}/items/{item}

target_section

string

ज़रूरी है. सेक्शन का वह संसाधन नाम जिसमें सेक्शन आइटम को ले जाना है.

फ़ॉर्मैट: users/{user}/sections/{section}

MoveSectionItemResponse

सेक्शन के आइटम को दूसरी जगह ले जाने के लिए जवाब वाला मैसेज.

फ़ील्ड
section_item

SectionItem

अपडेट किया गया सेक्शन आइटम.

PositionSectionRequest

किसी सेक्शन को जगह पर रखने के लिए अनुरोध करने वाला मैसेज.

फ़ील्ड
name

string

ज़रूरी है. उस सेक्शन का संसाधन नाम जिसे पोज़िशन करना है.

फ़ॉर्मैट: users/{user}/sections/{section}

यूनियन फ़ील्ड position. ज़रूरी है. सेक्शन की नई पोज़िशन. position इनमें से सिर्फ़ एक हो सकता है:
sort_order

int32

ज़रूरी नहीं. सेक्शन की सूची में सेक्शन की पोज़िशन. पोजीशन 0 से ज़्यादा होनी चाहिए. अगर सेक्शन की पोज़िशन, सेक्शन की संख्या से ज़्यादा है, तो सेक्शन को सूची के आखिर में जोड़ दिया जाएगा. इस कार्रवाई से, सेक्शन को दी गई जगह पर डाला जाता है. साथ ही, उस जगह पर मौजूद ओरिजनल सेक्शन और उसके नीचे मौजूद सेक्शन को अगली जगह पर ले जाया जाता है.

relative_position

Position

ज़रूरी नहीं. सेक्शन की सूची में सेक्शन की रिलेटिव पोज़िशन.

स्थिति

सेक्शन की पोज़िशन.

Enums
POSITION_UNSPECIFIED जगह की जानकारी नहीं दी गई है.
START सेक्शन की सूची की शुरुआत.
END सेक्शन की सूची खत्म हो गई है.

PositionSectionResponse

किसी सेक्शन को पोज़िशन करने के लिए जवाब का मैसेज.

फ़ील्ड
section

Section

अपडेट किया गया सेक्शन.

QuotedMessageMetadata

किसी ऐसे मैसेज के बारे में जानकारी जिसमें किसी दूसरे मैसेज का कोटेशन शामिल हो.

मैसेज अपडेट करते समय, quotedMessageMetadata फ़ील्ड को जोड़ा या बदला नहीं जा सकता. हालांकि, इसे हटाया जा सकता है.

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

फ़ील्ड
name

string

ज़रूरी है. कोट किए गए मैसेज का संसाधन नाम.

फ़ॉर्मैट: spaces/{space}/messages/{message}

last_update_time

Timestamp

ज़रूरी है. कोट किए गए मैसेज के बनाए जाने या अपडेट किए जाने का टाइमस्टैंप.

अगर मैसेज में बदलाव किया गया है, तो इस फ़ील्ड last_update_time का इस्तेमाल करें. अगर मैसेज में कभी बदलाव नहीं किया गया है, तो create_time का इस्तेमाल करें.

अगर last_update_time, कोट किए गए मैसेज के नए वर्शन से मेल नहीं खाता है, तो अनुरोध पूरा नहीं किया जा सकेगा.

quote_type

QuoteType

ज़रूरी नहीं. इससे कोटेशन का टाइप पता चलता है. अगर इस नीति की वैल्यू सेट नहीं है, तो यह पुराने वर्शन के साथ काम करने के लिए, मैसेज पढ़ने/लिखने के पाथ में REPLY पर डिफ़ॉल्ट रूप से सेट हो जाती है.

quoted_message_snapshot

QuotedMessageSnapshot

सिर्फ़ आउटपुट. कोट किए गए मैसेज के कॉन्टेंट का स्नैपशॉट.

forwarded_metadata

ForwardedMetadata

सिर्फ़ आउटपुट के लिए. कोट किए गए मैसेज के सोर्स स्पेस के बारे में मेटाडेटा. यह सिर्फ़ FORWARD कोट टाइप के लिए भरा जाता है.

QuoteType

कोट किए गए मैसेज का कोट टाइप.

Enums
QUOTE_TYPE_UNSPECIFIED रिज़र्व किया गया. इस वैल्यू का इस्तेमाल नहीं किया गया है.
REPLY

quote_type REPLY होने पर, ये काम किए जा सकते हैं:

  • अगर आपको किसी थ्रेड में जवाब देना है, तो उस थ्रेड में मौजूद किसी दूसरे मैसेज को कोट किया जा सकता है.

  • अगर कोई रूट मैसेज बनाया जा रहा है, तो उस स्पेस में मौजूद किसी दूसरे रूट मैसेज को कोट किया जा सकता है.

FORWARD

जब quote_type FORWARD हो, तब इन चीज़ों को कोट किया जा सकता है:

  • किसी दूसरे स्पेस से मिला मैसेज.

  • उसी स्पेस में मौजूद किसी दूसरे थ्रेड से मैसेज का जवाब दिया गया हो.

QuotedMessageSnapshot

यह कोट किए गए मैसेज के कॉन्टेंट का स्नैपशॉट दिखाता है. यह स्नैपशॉट, मैसेज को कोट या फ़ॉरवर्ड करने के समय का होता है

फ़ील्ड
sender

string

सिर्फ़ आउटपुट. कोट किए गए मैसेज के लेखक का नाम. यह REPLY और FORWARD, दोनों तरह के कोट के लिए उपलब्ध होता है.

text

string

सिर्फ़ आउटपुट. कोट किए गए मैसेज के टेक्स्ट कॉन्टेंट का स्नैपशॉट.

formatted_text

string

सिर्फ़ आउटपुट. इसमें कोट किया गया मैसेज text शामिल होता है. साथ ही,इसमें हाइपरलिंक, कस्टम इमोजी, मार्कअप वगैरह जैसे रिच फ़ॉर्मैटिंग को सपोर्ट करने के लिए मार्कअप जोड़े जाते हैं. यह सिर्फ़ FORWARD कोट टाइप के लिए उपलब्ध होता है.

annotations[]

Annotation

सिर्फ़ आउटपुट के लिए. कोट किए गए मैसेज के टेक्स्ट से पार्स किए गए एनोटेशन. यह सिर्फ़ FORWARD कोट टाइप के लिए भरा जाता है.

attachments[]

Attachment

सिर्फ़ आउटपुट. ये अटैचमेंट, कोट किए गए मैसेज का हिस्सा थे. ये कोट किए गए मैसेज के अटैचमेंट मेटाडेटा की कॉपी हैं. इन्हें सिर्फ़ फ़ॉरवर्ड किए गए कोट टाइप के लिए भरा जाता है.

प्रतिक्रिया

किसी मैसेज पर दी गई प्रतिक्रिया.

फ़ील्ड
name

string

आइडेंटिफ़ायर. रिएक्शन के रिसॉर्स का नाम.

फ़ॉर्मैट: spaces/{space}/messages/{message}/reactions/{reaction}

user

User

सिर्फ़ आउटपुट के लिए. प्रतिक्रिया देने वाला उपयोगकर्ता.

emoji

Emoji

ज़रूरी है. प्रतिक्रिया में इस्तेमाल की गई इमोजी.

ReactionBatchCreatedEventData

एक से ज़्यादा नई प्रतिक्रियाओं के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.reaction.v1.batchCreated

फ़ील्ड
reactions[]

ReactionCreatedEventData

नई प्रतिक्रियाओं की सूची.

ReactionBatchDeletedEventData

मिटाई गई कई प्रतिक्रियाओं के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.reaction.v1.batchDeleted

फ़ील्ड
reactions[]

ReactionDeletedEventData

मिटाई गई प्रतिक्रियाओं की सूची.

ReactionCreatedEventData

नई प्रतिक्रिया के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.reaction.v1.created

फ़ील्ड
reaction

Reaction

नई प्रतिक्रिया.

ReactionDeletedEventData

मिटाई गई प्रतिक्रिया के लिए इवेंट पेलोड.

कैंपेन किस तरह का है: google.workspace.chat.reaction.v1.deleted

फ़ील्ड
reaction

Reaction

हटाई गई प्रतिक्रिया.

ReplaceMessageCardsRequest

ReplaceMessageCards API के तरीके के लिए अनुरोध मैसेज.

फ़ील्ड
name

string

ज़रूरी है. मैसेज का संसाधन नाम.

फ़ॉर्मैट: spaces/{space}/messages/{message}

cards_v2[]

CardWithId

ज़रूरी नहीं. मैसेज में शामिल किए जाने वाले कार्ड का कलेक्शन. ये कार्ड, मैसेज के मौजूदा कार्ड की जगह ले लेंगे. अगर यह फ़ील्ड खाली है, तो मैसेज में शामिल ओरिजनल कार्ड हटा दिए जाएंगे.

ReplaceMessageCardsResponse

इस टाइप में कोई फ़ील्ड नहीं है.

ReplaceMessageCards API के लिए जवाब का मैसेज.

RichLinkMetadata

किसी संसाधन का रिच लिंक. रिच लिंक को मैसेज के सामान्य टेक्स्ट वाले हिस्से से जोड़ा जा सकता है. इसके अलावा, ये ऐसे चिप भी हो सकते हैं जो Google Workspace के संसाधनों से लिंक होते हैं. जैसे, Google Docs या Sheets. इनमें start_index और length की वैल्यू 0 होती है.

फ़ील्ड
uri

string

इस लिंक का यूआरआई.

यूनियन फ़ील्ड data. लिंक किए गए संसाधन का डेटा. data इनमें से सिर्फ़ एक हो सकता है:

RichLinkType

रिच लिंक टाइप. आने वाले समय में, इसमें और टाइप जोड़े जा सकते हैं.

Enums
DRIVE_FILE Google Drive के रिच लिंक का टाइप.
CHAT_SPACE यह Chat स्पेस के रिच लिंक का टाइप है. उदाहरण के लिए, स्पेस का स्मार्ट चिप.
GMAIL_MESSAGE Gmail मैसेज का रिच लिंक टाइप. खास तौर पर, Chat में शेयर करें सुविधा से मिला Gmail चिप. एपीआई सिर्फ़ GMAIL_MESSAGE रिच लिंक वाले मैसेज पढ़ने की सुविधा देता है.
MEET_SPACE यह Meet के मैसेज में शामिल किए जाने वाले रिच लिंक का टाइप है. उदाहरण के लिए, Meet का चिप.
CALENDAR_EVENT कैलेंडर मैसेज का रिच लिंक टाइप. उदाहरण के लिए, Calendar चिप.

SearchMessageResult

मैसेज खोजने पर मिला एक नतीजा.

फ़ील्ड
message

Message

मिलता-जुलता मैसेज.

space_mute_setting

MuteSetting

कॉल करने वाले व्यक्ति के लिए, उस स्पेस की म्यूट सेटिंग जहां मैसेज पोस्ट किया गया है. कॉल करने वाला ऐप्लिकेशन इस जानकारी का इस्तेमाल करके यह तय कर सकता है कि मैसेज को कैसे प्रोसेस करना है. यह इस बात पर निर्भर करता है कि उपयोगकर्ता के लिए स्पेस म्यूट है या नहीं.

यह वैल्यू सिर्फ़ तब दिखती है, जब अनुरोध का व्यू SEARCH_MESSAGES_VIEW_FULL हो और कॉल करने वाले क्रेडेंशियल में, यहां दिया गया अनुमति का दायरा शामिल हो:

  • https://www.googleapis.com/auth/chat.users.spacesettings
read

bool

इससे पता चलता है कि कॉल करने वाले व्यक्ति ने मैच किया गया मैसेज पढ़ा है या नहीं.

यह सिर्फ़ तब दिखता है, जब अनुरोध व्यू SEARCH_MESSAGES_VIEW_FULL हो और कॉल करने वाले क्रेडेंशियल में, यहां दिए गए अनुमति के स्कोप में से कोई एक शामिल हो:

  • https://www.googleapis.com/auth/chat.users.readstate.readonly
  • https://www.googleapis.com/auth/chat.users.readstate

SearchMessagesRequest

मैसेज खोजने के लिए अनुरोध मैसेज.

फ़ील्ड
parent

string

ज़रूरी है. उस स्पेस का संसाधन नाम जिसमें खोजना है.

उपयोगकर्ता के पास जिन स्पेस का ऐक्सेस है उनमें खोजने के लिए, इस फ़ील्ड को spaces/- पर सेट करें. parent के लिए किसी अन्य वैल्यू का इस्तेमाल करने पर, INVALID_ARGUMENT गड़बड़ी होती है.

एक या उससे ज़्यादा स्पेस में खोज करने के लिए, filter में space.name या space.display_name का इस्तेमाल करें.

filter

string

ज़रूरी है. सर्च क्वेरी.

क्वेरी में खोज के लिए एक या उससे ज़्यादा कीवर्ड दिए जा सकते हैं. इनका इस्तेमाल नतीजों को फ़िल्टर करने के लिए किया जाता है,

इन मैसेज फ़ील्ड का इस्तेमाल करके भी नतीजों को फ़िल्टर किया जा सकता है:

  • create_time: यह RFC-3339 फ़ॉर्मैट में टाइमस्टैंप स्वीकार करता है. साथ ही, तुलना करने वाले इन ऑपरेटरों का इस्तेमाल किया जा सकता है: < और >=.
  • sender.name: यह भेजने वाले का संसाधन नाम (users/{user}) है. यह सिर्फ़ = के साथ काम करता है. ईमेल पते को {user} के लिए उपनाम के तौर पर इस्तेमाल किया जा सकता है. उदाहरण के लिए, users/example@gmail.com, जहां example@gmail.com Google Chat इस्तेमाल करने वाले व्यक्ति का ईमेल पता है.
  • space.name: यह उस स्पेस का संसाधन नाम है जहां मैसेज पोस्ट किया गया है. (spaces/{space}). सिर्फ़ = के साथ काम करता है. अगर यह फ़िल्टर सेट नहीं किया जाता है, तो खोज उन सभी डायरेक्ट मैसेज और स्पेस में की जाती है जिन्हें उपयोगकर्ता, स्पेस के सदस्य के तौर पर ऐक्सेस कर सकता है.
  • space.display_name: यह ऑपरेटर : (है) के साथ काम करता है. साथ ही, स्पेस के डिसप्ले नेम के कुछ हिस्से के मैच होने के आधार पर, स्पेस को फ़िल्टर करता है. नतीजे, स्पेस के सबसे ज़्यादा मैच होने वाले पांच नामों तक सीमित होते हैं. उदाहरण के लिए, space.display_name:Project, डिसप्ले नेम में "प्रोजेक्ट" शब्द वाले टॉप पांच स्पेस में मौजूद मैसेज खोजता है.
  • attachment: यह ऑपरेटर :* (कोई भी) के साथ काम करता है, ताकि अटैचमेंट की मौजूदगी की जांच की जा सके. अगर attachment:* तय किया गया है, तो सिर्फ़ ऐसे मैसेज दिखाए जाते हैं जिनमें कम से कम एक अटैचमेंट हो.
  • annotations.user_mentions.user.name: यह टैग किए गए उपयोगकर्ता (users/{user}) का संसाधन नाम है. यह सिर्फ़ : (has) के साथ काम करता है. उदाहरण के लिए: annotations.user_mentions.user.name:"users/1234567890" से सिर्फ़ वे मैसेज दिखते हैं जिनमें किसी उपयोगकर्ता को टैग किया गया है. इसके अलावा, कॉलर को टैग करने वाले मैसेज को फ़िल्टर करने के लिए, me उपनाम का इस्तेमाल किया जा सकता है. उदाहरण के लिए: annotations.user_mentions.user.name:users/me. {user} के लिए, ईमेल पते को भी उपनाम के तौर पर इस्तेमाल किया जा सकता है. उदाहरण के लिए, users/example@gmail.com.

बेहतर तरीके से फ़िल्टर करने के लिए, ये फ़ंक्शन भी उपलब्ध हैं:

  • has_link(): सिर्फ़ ऐसे मैसेज दिखाता है जिनमें मैसेज के टेक्स्ट में कम से कम एक हाइपरलिंक हो.
  • is_unread(): इस फ़िल्टर से, कॉल करने वाले व्यक्ति के पढ़े गए मैसेज हट जाते हैं.

space.display_name फ़िल्टर का इस्तेमाल करने के लिए, कॉलिंग क्रेडेंशियल में इनमें से कोई एक अनुमति का दायरा शामिल होना चाहिए:

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

is_unread() फ़िल्टर का इस्तेमाल करने के लिए, कॉलिंग क्रेडेंशियल में इनमें से कोई एक अनुमति का दायरा शामिल होना चाहिए:

  • https://www.googleapis.com/auth/chat.users.readstate.readonly
  • https://www.googleapis.com/auth/chat.users.readstate

अलग-अलग फ़ील्ड में, सिर्फ़ AND ऑपरेटर इस्तेमाल किए जा सकते हैं. sender.name = "users/1234567890" AND is_unread(), इसका एक मान्य उदाहरण है. AND शब्द का इस्तेमाल करना ज़रूरी नहीं है. अगर इसे शामिल नहीं किया जाता है, तो इसका मतलब यही होता है. उदाहरण के लिए, sender.name = "users/1234567890" is_unread() मान्य है और यह पिछले उदाहरण के बराबर है. अमान्य उदाहरण sender.name = "users/1234567890" OR is_unread() है, क्योंकि sender.name = "users/1234567890" OR is_unread() का इस्तेमाल अलग-अलग फ़ील्ड के बीच नहीं किया जा सकता.OR

एक ही फ़ील्ड में:

  • create_time सिर्फ़ AND के साथ काम करता है. इसका इस्तेमाल सिर्फ़ इंटरवल दिखाने के लिए किया जा सकता है. जैसे, create_time >= "2022-01-01T00:00:00+00:00" AND create_time < "2023-01-01T00:00:00+00:00".
  • sender.name सिर्फ़ OR ऑपरेटर के साथ काम करता है. उदाहरण के लिए: sender.name = "users/1234567890" OR sender.name = "users/0987654321".
  • space.name सिर्फ़ OR ऑपरेटर के साथ काम करता है. उदाहरण के लिए: space.name = "spaces/ABCDEFGH" OR space.name = "spaces/QWERTYUI".
  • space.display_name में AND और OR ऑपरेटर इस्तेमाल किए जा सकते हैं, लेकिन दोनों को एक साथ इस्तेमाल नहीं किया जा सकता. उदाहरण के लिए: space.display_name:Project AND space.display_name:Tasks से ऐसे मैसेज दिखते हैं जो उन स्पेस में मौजूद हैं जिनके डिसप्ले नेम में Project और Tasks, दोनों शामिल हैं. वहीं, space.display_name:Project OR space.display_name:Tasks से ऐसे मैसेज दिखते हैं जो उन स्पेस में मौजूद हैं जिनके डिसप्ले नेम में Project या Tasks या दोनों शामिल हैं.
  • annotations.user_mentions.user.name में AND और OR ऑपरेटर इस्तेमाल किए जा सकते हैं, लेकिन दोनों को एक साथ इस्तेमाल नहीं किया जा सकता. उदाहरण के लिए: annotations.user_mentions.user.name:"users/1234567890" AND annotations.user_mentions.user.name:"users/0987654321" सिर्फ़ ऐसे मैसेज दिखाता है जिनमें दोनों उपयोगकर्ताओं का ज़िक्र किया गया हो. वहीं, annotations.user_mentions.user.name:"users/1234567890" OR annotations.user_mentions.user.name:"users/0987654321" ऐसे मैसेज दिखाता है जिनमें किसी एक उपयोगकर्ता या दोनों का ज़िक्र किया गया हो.

एक ही क्वेरी में AND और OR ऑपरेटर को एक साथ इस्तेमाल करते समय, ऑपरेटर प्रेसिडेंस को अलग-अलग करने के लिए कोष्ठक का इस्तेमाल करना ज़रूरी है. उदाहरण के लिए: (sender.name="users/me" OR sender.name="users/123456") AND is_unread(). हालांकि, ऐसा न करने पर ब्रैकेट लगाना ज़रूरी नहीं है.

क्वेरी के ये उदाहरण मान्य हैं:

"Pending reports" AND create_time >= "2023-01-01T00:00:00Z"

sender.name = "users/example@gmail.com"

annotations.user_mentions.user.name:"users/0987654321"

attachment:* AND space.name = "spaces/ABCDEFGH"

tasks AND is_unread() AND sender.name = "users/1234567890"

"things to do" "urgent"

(sender.name = "users/1234567890")
AND (create_time < "2023-05-01T00:00:00Z")

tasks AND space.name = "spaces/ABCDEFGH" AND has_link()

"project one" is_unread()

space.display_name:Project tasks

क्वेरी में ज़्यादा से ज़्यादा 1,000 वर्ण इस्तेमाल किए जा सकते हैं.

अमान्य क्वेरी को सर्वर, INVALID_ARGUMENT गड़बड़ी के साथ अस्वीकार कर देता है.

page_size

int32

ज़रूरी नहीं. ज़्यादा से ज़्यादा कितने नतीजे दिखाने हैं. ऐसा हो सकता है कि सेवा इस वैल्यू से कम नतीजे दिखाए.

अगर इसे तय नहीं किया गया है, तो ज़्यादा से ज़्यादा 25 नतीजे दिखते हैं.

ज़्यादा से ज़्यादा वैल्यू 100 हो सकती है. अगर 100 से ज़्यादा वैल्यू का इस्तेमाल किया जाता है, तो उसे अपने-आप 100 पर सेट कर दिया जाता है.

page_token

string

ज़रूरी नहीं. यह टोकन, खोज के मैसेज से जुड़े पिछले कॉल से मिला है. अगला पेज पाने के लिए, यह पैरामीटर दें.

पेज नंबर के हिसाब से नतीजे दिखाने के दौरान, दिए गए अन्य सभी पैरामीटर, पेज टोकन देने वाले कॉल से मेल खाने चाहिए. अन्य पैरामीटर को अलग-अलग वैल्यू पास करने से, अनचाहे नतीजे मिल सकते हैं.

order_by

string

ज़रूरी नहीं. नतीजों की सूची को किस क्रम में लगाया गया है.

इन एट्रिब्यूट के हिसाब से ऑर्डर किया जा सकता है:

  • create_time: इससे नतीजों को मैसेज बनाए जाने के समय के हिसाब से क्रम में लगाया जाता है. डिफ़ॉल्ट मान.
  • relevance: नतीजों को इस आधार पर क्रम से लगाता है कि वे कितने काम के हैं.

डिफ़ॉल्ट रूप से, create_time desc के हिसाब से क्रम तय किया जाता है. हर क्वेरी के लिए, सिर्फ़ एक क्रम (create_time या relevance) इस्तेमाल किया जा सकता है. सिर्फ़ घटते क्रम (desc) का इस्तेमाल किया जा सकता है. साथ ही, इसे क्रम तय करने वाले एट्रिब्यूट के बाद तय किया जाना चाहिए.

view

SearchMessagesView

ज़रूरी नहीं. इससे यह तय किया जाता है कि खोज के नतीजों को किस तरह से दिखाया जाए. डिफ़ॉल्ट वैल्यू SEARCH_MESSAGES_VIEW_BASIC है.

SearchMessagesView

ऐसे व्यू जिनके लिए, खोज के कुछ नतीजे दिखाए जा सकते हैं.

Enums
SEARCH_MESSAGES_VIEW_UNSPECIFIED डिफ़ॉल्ट / सेट नहीं की गई वैल्यू. एपीआई, डिफ़ॉल्ट रूप से बुनियादी व्यू पर सेट होगा.
SEARCH_MESSAGES_VIEW_BASIC नतीजों में सिर्फ़ मैच किए गए मैसेज शामिल होते हैं. हालांकि, इसमें कोई अतिरिक्त मेटाडेटा शामिल नहीं होता. यह डिफ़ॉल्ट मान है.
SEARCH_MESSAGES_VIEW_FULL इसमें नतीजों में मौजूद सभी चीज़ें शामिल होती हैं: मैच किए गए मैसेज और अतिरिक्त मेटाडेटा.

SearchMessagesResponse

मैसेज खोजने के लिए जवाब का मैसेज.

फ़ील्ड
results[]

SearchMessageResult

क्वेरी से मेल खाने वाले खोज नतीजों की सूची.

next_page_token

string

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

SearchSpacesRequest

क्वेरी के आधार पर, स्पेस की सूची खोजने का अनुरोध.

फ़ील्ड
use_admin_access

bool

जब true होता है, तो यह तरीका उपयोगकर्ता के Google Workspace एडमिन के अधिकारों का इस्तेमाल करके काम करता है.

कॉल करने वाला व्यक्ति, Google Workspace एडमिन होना चाहिए. साथ ही, उसके पास चैट और स्पेस में होने वाली बातचीत को मैनेज करने का अधिकार होना चाहिए.

इसके लिए, chat.admin.spaces.readonly या chat.admin.spaces OAuth 2.0 स्कोप की ज़रूरत होती है.

फ़िलहाल, यह तरीका सिर्फ़ एडमिन ऐक्सेस के लिए काम करता है. इसलिए, इस फ़ील्ड के लिए सिर्फ़ true स्वीकार किया जाता है.

page_size

int32

दिखाए जाने वाले स्पेस की ज़्यादा से ज़्यादा संख्या. सेवा, इस वैल्यू से कम स्पेस दिखा सकती है.

अगर यह तय नहीं किया गया है, तो ज़्यादा से ज़्यादा 100 स्पेस दिखाए जाते हैं.

इसकी ज़्यादा से ज़्यादा वैल्यू 1,000 हो सकती है. अगर 1,000 से ज़्यादा वैल्यू का इस्तेमाल किया जाता है, तो उसे अपने-आप 1,000 में बदल दिया जाता है.

page_token

string

यह टोकन, search spaces API को किए गए पिछले कॉल से मिला है. अगला पेज पाने के लिए, यह पैरामीटर दें.

पेज नंबर के हिसाब से नतीजे दिखाने के दौरान, दिए गए अन्य सभी पैरामीटर, पेज टोकन देने वाले कॉल से मेल खाने चाहिए. अन्य पैरामीटर को अलग-अलग वैल्यू पास करने से, अनचाहे नतीजे मिल सकते हैं.

query

string

ज़रूरी है. सर्च क्वेरी.

इन पैरामीटर का इस्तेमाल करके खोजा जा सकता है:

  • create_time
  • customer
  • display_name
  • external_user_allowed
  • last_active_time
  • space_history_state
  • space_type

create_time और last_active_time, RFC-3339 फ़ॉर्मैट में टाइमस्टैंप स्वीकार करते हैं. साथ ही, तुलना करने के लिए इस्तेमाल किए जा सकने वाले ऑपरेटर ये हैं: =, <, >, <=, >=.

customer ज़रूरी है. इसका इस्तेमाल यह बताने के लिए किया जाता है कि किस ग्राहक के स्पेस फ़ेच करने हैं. customers/my_customer ही इस्तेमाल की जा सकने वाली वैल्यू है.

display_name सिर्फ़ HAS (:) ऑपरेटर को स्वीकार करता है. मिलान के लिए दिए गए टेक्स्ट को पहले टोकन में बदला जाता है. इसके बाद, हर टोकन को केस-इनसेंसिटिव तरीके से प्रीफ़िक्स के तौर पर मैच किया जाता है. साथ ही, इसे स्पेस के display_name में सबस्ट्रिंग के तौर पर कहीं भी मैच किया जाता है. उदाहरण के लिए, Fun Eve, Fun event या The evening was fun से मेल खाता है, लेकिन notFun event या even से नहीं.

external_user_allowed, true या false में से किसी एक को स्वीकार करता है.

space_history_state सिर्फ़ space संसाधन के historyState फ़ील्ड से वैल्यू स्वीकार करता है.

space_type प्रॉपर्टी की वैल्यू देना ज़रूरी है. इसकी सिर्फ़ एक मान्य वैल्यू है: SPACE.

अलग-अलग फ़ील्ड में, सिर्फ़ AND ऑपरेटर इस्तेमाल किए जा सकते हैं. मान्य उदाहरण space_type = "SPACE" AND display_name:"Hello" है और अमान्य उदाहरण space_type = "SPACE" OR display_name:"Hello" है.

एक ही फ़ील्ड में, space_type, AND या OR ऑपरेटर के साथ काम नहीं करता. display_name, 'space_history_state', और 'external_user_allowed' सिर्फ़ OR ऑपरेटर के साथ काम करते हैं. last_active_time और create_time, दोनों AND और OR ऑपरेटर के साथ काम करते हैं. AND का इस्तेमाल सिर्फ़ इंटरवल दिखाने के लिए किया जा सकता है. जैसे, last_active_time < "2022-01-01T00:00:00+00:00" AND last_active_time > "2023-01-01T00:00:00+00:00".

क्वेरी के ये उदाहरण मान्य हैं:

customer = "customers/my_customer" AND space_type = "SPACE"

customer = "customers/my_customer" AND space_type = "SPACE" AND
display_name:"Hello World"

customer = "customers/my_customer" AND space_type = "SPACE" AND
(last_active_time < "2020-01-01T00:00:00+00:00" OR last_active_time >
"2022-01-01T00:00:00+00:00")

customer = "customers/my_customer" AND space_type = "SPACE" AND
(display_name:"Hello World" OR display_name:"Fun event") AND
(last_active_time > "2020-01-01T00:00:00+00:00" AND last_active_time <
"2022-01-01T00:00:00+00:00")

customer = "customers/my_customer" AND space_type = "SPACE" AND
(create_time > "2019-01-01T00:00:00+00:00" AND create_time <
"2020-01-01T00:00:00+00:00") AND (external_user_allowed = "true") AND
(space_history_state = "HISTORY_ON" OR space_history_state = "HISTORY_OFF")
order_by

string

ज़रूरी नहीं. स्पेस की सूची को किस क्रम में लगाया गया है.

इन एट्रिब्यूट के हिसाब से ऑर्डर किया जा सकता है:

  • membership_count.joined_direct_human_user_count — इससे पता चलता है कि कितने लोगों ने सीधे तौर पर किसी स्पेस में शामिल होने का अनुरोध किया है.
  • last_active_time — इससे पता चलता है कि इस स्पेस के किसी विषय में, ज़रूरी शर्तें पूरी करने वाला आखिरी आइटम कब जोड़ा गया था.
  • create_time — इससे स्पेस बनाने का समय पता चलता है.

ऑर्डर करने की कार्रवाई के लिए मान्य वैल्यू ये हैं:

  • ASC का इस्तेमाल बढ़ते क्रम के लिए किया जाता है. डिफ़ॉल्ट मान.

  • घटते क्रम के लिए, DESC.

इन सिंटैक्स का इस्तेमाल किया जा सकता है:

  • membership_count.joined_direct_human_user_count DESC
  • membership_count.joined_direct_human_user_count ASC
  • last_active_time DESC
  • last_active_time ASC
  • create_time DESC
  • create_time ASC

SearchSpacesResponse

जवाब में, खोजे गए स्पेस से जुड़े स्पेस की सूची.

फ़ील्ड
spaces[]

Space

अनुरोध किए गए स्पेस का पेज.

next_page_token

string

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

total_size

int32

सभी पेजों पर, क्वेरी से मेल खाने वाले स्पेस की कुल संख्या. अगर नतीजे में 10,000 से ज़्यादा स्पेस हैं, तो यह वैल्यू अनुमानित होती है.

सेक्शन

यह Google Chat में मौजूद सेक्शन को दिखाता है. सेक्शन की मदद से, उपयोगकर्ता अपने स्पेस को व्यवस्थित कर सकते हैं. सेक्शन दो तरह के होते हैं:

  1. सिस्टम सेक्शन: ये पहले से तय किए गए सेक्शन होते हैं, जिन्हें Google Chat मैनेज करता है. इनके संसाधन के नाम तय होते हैं. इन्हें न तो बनाया जा सकता है और न ही मिटाया जा सकता है. साथ ही, इनके display_name में बदलाव भी नहीं किया जा सकता. उदाहरण के लिए:

    • users/{user}/sections/default-direct-messages
    • users/{user}/sections/default-spaces
    • users/{user}/sections/default-apps
  2. कस्टम सेक्शन: ये ऐसे सेक्शन होते हैं जिन्हें उपयोगकर्ता बनाता और मैनेज करता है. CreateSection का इस्तेमाल करके अपनी पसंद का सेक्शन बनाने के लिए, display_name ज़रूरी है. कस्टम सेक्शन को UpdateSection का इस्तेमाल करके अपडेट किया जा सकता है और DeleteSection का इस्तेमाल करके मिटाया जा सकता है.

फ़ील्ड
name

string

आइडेंटिफ़ायर. सेक्शन के संसाधन का नाम.

सिस्टम सेक्शन के लिए, सेक्शन आईडी एक कॉन्स्टेंट स्ट्रिंग होती है:

  • DEFAULT_DIRECT_MESSAGES: users/{user}/sections/default-direct-messages
  • DEFAULT_SPACES: users/{user}/sections/default-spaces
  • DEFAULT_APPS: users/{user}/sections/default-apps

फ़ॉर्मैट: users/{user}/sections/{section}

display_name

string

ज़रूरी नहीं. सेक्शन का डिसप्ले नेम. यह सिर्फ़ CUSTOM_SECTION टाइप के सेक्शन के लिए अपने-आप भरता है. इसमें ज़्यादा से ज़्यादा 80 वर्ण इस्तेमाल किए जा सकते हैं. CUSTOM_SECTION बनाते समय यह एट्रिब्यूट ज़रूरी है.

sort_order

int32

सिर्फ़ आउटपुट. यह सेक्शन, अन्य सेक्शन के मुकाबले किस क्रम में है. कम sort_order वैल्यू वाले सेक्शन, ज़्यादा वैल्यू वाले सेक्शन से पहले दिखते हैं.

type

SectionType

ज़रूरी है. सेक्शन का टाइप.

SectionType

सेक्शन के टाइप.

Enums
SECTION_TYPE_UNSPECIFIED सेक्शन का टाइप तय नहीं किया गया है.
CUSTOM_SECTION अपनी पसंद का सेक्शन.
DEFAULT_DIRECT_MESSAGES डिफ़ॉल्ट सेक्शन में, दो लोगों के बीच हुए DIRECT_MESSAGE या ऐसे GROUP_CHAT स्पेस होते हैं जो किसी अपनी पसंद के सेक्शन से जुड़े नहीं होते.
DEFAULT_SPACES डिफ़ॉल्ट स्पेस, जो किसी अपनी पसंद के सेक्शन से नहीं जुड़े हैं.
DEFAULT_APPS डिफ़ॉल्ट सेक्शन में, उपयोगकर्ता के इंस्टॉल किए गए ऐप्लिकेशन शामिल होते हैं.

SectionItem

उपयोगकर्ता के तय किए गए सेक्शन का आइटम. इसका इस्तेमाल सेक्शन के आइटम दिखाने के लिए किया जाता है. जैसे, किसी सेक्शन में ग्रुप किए गए स्पेस.

फ़ील्ड
name

string

पहचानकर्ता. सेक्शन आइटम का संसाधन नाम.

फ़ॉर्मैट: users/{user}/sections/{section}/items/{item}

यूनियन फ़ील्ड item. ज़रूरी है. सेक्शन आइटम. item इनमें से सिर्फ़ एक हो सकता है:
space

string

ज़रूरी नहीं. स्पेस के संसाधन का नाम.

फ़ॉर्मैट: spaces/{space}

SetUpSpaceRequest

स्पेस बनाने और उसमें चुने गए उपयोगकर्ताओं को जोड़ने का अनुरोध करें.

फ़ील्ड
space

Space

ज़रूरी है. Space.spaceType फ़ील्ड को भरना ज़रूरी है.

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

ग्रुप चैट बनाने के लिए, Space.spaceType को GROUP_CHAT पर सेट करें. Space.displayName को सेट न करें.

लोगों के बीच 1:1 बातचीत करने के लिए, Space.spaceType को DIRECT_MESSAGE पर सेट करें और Space.singleUserBotDm को false पर सेट करें. Space.displayName या Space.spaceDetails को सेट न करें.

किसी व्यक्ति और कॉल करने वाले Chat ऐप्लिकेशन के बीच 1:1 बातचीत करने के लिए, Space.spaceType को DIRECT_MESSAGE और Space.singleUserBotDm को true पर सेट करें. Space.displayName या Space.spaceDetails को सेट न करें.

अगर DIRECT_MESSAGE स्पेस पहले से मौजूद है, तो नया स्पेस बनाने के बजाय उसी स्पेस को दिखाया जाता है.

request_id

string

ज़रूरी नहीं. इस अनुरोध के लिए यूनीक आइडेंटिफ़ायर. हमारा सुझाव है कि आप रैंडम यूयूआईडी का इस्तेमाल करें. मौजूदा अनुरोध आईडी तय करने पर, नया स्पेस बनाने के बजाय, उस आईडी से बनाया गया स्पेस दिखता है. पुष्टि किए गए किसी दूसरे उपयोगकर्ता के साथ, उसी Chat ऐप्लिकेशन से मौजूदा अनुरोध आईडी तय करने पर गड़बड़ी होती है.

memberships[]

Membership

ज़रूरी नहीं. Google Chat के उन उपयोगकर्ताओं या ग्रुप को चुनें जिन्हें स्पेस में शामिल होने का न्योता भेजना है. कॉल करने वाले व्यक्ति का नाम शामिल न करें, क्योंकि उसे अपने-आप जोड़ दिया जाता है.

फ़िलहाल, इस सेट में कॉल करने वाले व्यक्ति के अलावा, 49 और लोगों को शामिल किया जा सकता है.

किसी व्यक्ति को सदस्य के तौर पर जोड़ने के लिए, Membership.member फ़ील्ड में user होना चाहिए. साथ ही, name फ़ील्ड में वैल्यू होनी चाहिए (फ़ॉर्मैट: users/{user}) और type को User.Type.HUMAN पर सेट होना चाहिए. किसी स्पेस को सेट अप करते समय, सिर्फ़ लोगों को जोड़ा जा सकता है. Chat ऐप्लिकेशन जोड़ने की सुविधा, सिर्फ़ कॉलिंग ऐप्लिकेशन के साथ डायरेक्ट मैसेज सेट अप करने के लिए उपलब्ध है. {user} के लिए उपयोगकर्ता के ईमेल को उपनाम के तौर पर इस्तेमाल करके भी सदस्यों को जोड़ा जा सकता है. उदाहरण के लिए, user.name को users/example@gmail.com के तौर पर इस्तेमाल किया जा सकता है. Gmail उपयोगकर्ताओं या बाहरी Google Workspace डोमेन के उपयोगकर्ताओं को न्योता भेजने के लिए, {user} के लिए उपयोगकर्ता के ईमेल का इस्तेमाल करना ज़रूरी है.

Google ग्रुप की सदस्यता के लिए, Membership.group_member फ़ील्ड में group होना चाहिए. साथ ही, name फ़ील्ड में वैल्यू भरी होनी चाहिए (फ़ॉर्मैट groups/{group}). Space.spaceType को SPACE पर सेट करने पर ही, Google ग्रुप जोड़े जा सकते हैं.

Space.spaceType को SPACE पर सेट करते समय, यह एट्रिब्यूट ज़रूरी नहीं है.

Space.spaceType एट्रिब्यूट की वैल्यू GROUP_CHAT पर सेट करने के साथ-साथ, कम से कम दो सदस्यताएं सेट करने पर यह एट्रिब्यूट ज़रूरी है.

किसी व्यक्ति के लिए Space.spaceType को DIRECT_MESSAGE पर सेट करते समय, यह एट्रिब्यूट देना ज़रूरी है. साथ ही, सिर्फ़ एक सदस्यता होनी चाहिए.

जब किसी व्यक्ति और कॉल करने वाले Chat ऐप्लिकेशन के बीच 1:1 बातचीत की जा रही हो, तब यह फ़ील्ड खाली होना चाहिए. ऐसा तब होता है, जब Space.spaceType को DIRECT_MESSAGE और Space.singleUserBotDm को true पर सेट किया जाता है.

SlashCommand

Google Chat में स्लैश कमांड के बारे में मेटाडेटा.

फ़ील्ड
command_id

int64

स्लैश कमांड का आईडी.

SlashCommandMetadata

स्लैश कमांड (/) के लिए एनोटेशन मेटाडेटा.

फ़ील्ड
bot

User

वह Chat ऐप्लिकेशन जिसकी कमांड शुरू की गई थी.

type

Type

स्लैश कमांड का टाइप.

command_name

string

इनवोक किए गए स्लैश कमांड का नाम.

command_id

int64

बुलाए गए स्लैश कमांड का आईडी.

triggers_dialog

bool

इससे पता चलता है कि स्लैश कमांड, डायलॉग के लिए है या नहीं.

टाइप

Enums
TYPE_UNSPECIFIED इनम की डिफ़ॉल्ट वैल्यू. इसका इस्तेमाल न करें.
ADD स्पेस में Chat ऐप्लिकेशन जोड़ें.
INVOKE स्पेस में स्लैश कमांड का इस्तेमाल करना.

स्पेस

Google Chat में मौजूद कोई स्पेस. स्पेस, दो या उससे ज़्यादा लोगों के बीच की बातचीत होती है. इसके अलावा, यह किसी व्यक्ति और Chat ऐप्लिकेशन के बीच की 1:1 बातचीत भी हो सकती है.

फ़ील्ड
name

string

आइडेंटिफ़ायर. स्पेस का संसाधन नाम.

फ़ॉर्मैट: spaces/{space}

यहां {space}, स्पेस के लिए सिस्टम से असाइन किया गया आईडी दिखाता है. स्पेस आईडी पाने के लिए, spaces.list() तरीके को कॉल करें या स्पेस के यूआरएल से स्पेस आईडी पाएं. उदाहरण के लिए, अगर स्पेस का यूआरएल https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA है, तो स्पेस आईडी AAAAAAAAA होगा.

type
(deprecated)

Type

सिर्फ़ आउटपुट के लिए. इस्तेमाल बंद कर दिया गया है: इसके बजाय, space_type का इस्तेमाल करें. स्पेस का टाइप.

space_type

SpaceType

ज़रूरी नहीं. स्पेस किस तरह का है. स्पेस बनाते समय या किसी स्पेस के टाइप को अपडेट करते समय यह ज़रूरी है. सिर्फ़ आउटपुट के लिए.

single_user_bot_dm

bool

ज़रूरी नहीं. क्या स्पेस, Chat ऐप्लिकेशन और किसी व्यक्ति के बीच का डीएम है.

threaded
(deprecated)

bool

सिर्फ़ आउटपुट के लिए. इस्तेमाल बंद कर दिया गया है: इसके बजाय, spaceThreadingState का इस्तेमाल करें. इस स्पेस में मैसेज थ्रेड किए गए हैं या नहीं.

display_name

string

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

डायरेक्ट मैसेज के लिए, यह फ़ील्ड खाली हो सकता है.

इसमें ज़्यादा से ज़्यादा 128 वर्ण डाले जा सकते हैं.

external_user_allowed

bool

ज़रूरी नहीं. इम्यूटेबल. इस स्पेस में, Google Chat इस्तेमाल करने वाले किसी भी व्यक्ति को सदस्य के तौर पर शामिल होने की अनुमति है या नहीं. Google Workspace संगठन में स्पेस बनाते समय इनपुट. इन स्थितियों में स्पेस बनाते समय, इस फ़ील्ड को शामिल न करें:

  • पुष्टि किया गया उपयोगकर्ता, उपभोक्ता खाता (मैनेज नहीं किया जा रहा उपयोगकर्ता खाता) इस्तेमाल करता है. डिफ़ॉल्ट रूप से, उपभोक्ता खाते से बनाए गए स्पेस में Google Chat का कोई भी उपयोगकर्ता शामिल हो सकता है.

मौजूदा स्पेस के लिए, यह फ़ील्ड सिर्फ़ आउटपुट के लिए होता है.

space_threading_state

SpaceThreadingState

सिर्फ़ आउटपुट के लिए. Chat स्पेस में थ्रेडिंग की स्थिति.

space_details

SpaceDetails

ज़रूरी नहीं. स्पेस के बारे में जानकारी, जिसमें स्पेस का ब्यौरा और नियम शामिल हैं.

space_history_state

HistoryState

ज़रूरी नहीं. इस स्पेस में मौजूद मैसेज और थ्रेड के लिए, मैसेज के इतिहास की स्थिति.

import_mode

bool

ज़रूरी नहीं. यह स्पेस, Import Mode में Google Workspace में डेटा माइग्रेट करने के दौरान बनाया गया है या नहीं. स्पेस इंपोर्ट किए जाने के दौरान, वे उपयोगकर्ताओं को नहीं दिखते. इंपोर्ट पूरा होने के बाद ही वे दिखते हैं.

Import Mode में स्पेस बनाने के लिए, उपयोगकर्ता की पुष्टि करना ज़रूरी है.

create_time

Timestamp

ज़रूरी नहीं. इम्यूटेबल. Chat में बनाए गए स्पेस के लिए, स्पेस बनाने का समय. यह फ़ील्ड सिर्फ़ आउटपुट के लिए होता है. हालांकि, इसका इस्तेमाल इंपोर्ट मोड वाले स्पेस में किया जा सकता है.

इंपोर्ट मोड वाले स्पेस के लिए, इस फ़ील्ड को उस ऐतिहासिक टाइमस्टैंप पर सेट करें जिस पर सोर्स में स्पेस बनाया गया था, ताकि स्पेस बनाने का ओरिजनल समय सुरक्षित रखा जा सके.

यह फ़ील्ड, आउटपुट में सिर्फ़ तब दिखता है, जब spaceType की वैल्यू GROUP_CHAT या SPACE हो.

last_active_time

Timestamp

सिर्फ़ आउटपुट के लिए. स्पेस में मौजूद आखिरी मैसेज का टाइमस्टैंप.

admin_installed

bool

सिर्फ़ आउटपुट के लिए. Chat ऐप्लिकेशन के साथ डायरेक्ट मैसेज (डीएम) वाले स्पेस के लिए, भले ही स्पेस को Google Workspace एडमिन ने बनाया हो. एडमिन, अपने संगठन के उपयोगकर्ताओं की ओर से Chat ऐप्लिकेशन के साथ डायरेक्ट मैसेज की सुविधा को इंस्टॉल और सेट अप कर सकते हैं.

एडमिन के ज़रिए इंस्टॉल किए जाने की सुविधा के लिए, आपके Chat ऐप्लिकेशन में डायरेक्ट मैसेज भेजने की सुविधा होनी चाहिए.

membership_count

MembershipCount

सिर्फ़ आउटपुट. इसमें, पैसे चुकाकर बने सदस्यों की संख्या को सदस्य के टाइप के हिसाब से ग्रुप किया जाता है. यह तब दिखता है, जब space_type की वैल्यू SPACE, DIRECT_MESSAGE या GROUP_CHAT होती है.

access_settings

AccessSettings

ज़रूरी नहीं. इससे स्पेस की ऐक्सेस सेटिंग के बारे में पता चलता है. यह फ़ील्ड तब ही दिखता है, जब space_type SPACE पर सेट हो.

space_uri

string

सिर्फ़ आउटपुट के लिए. किसी उपयोगकर्ता के लिए, स्पेस को ऐक्सेस करने का यूआरआई.

import_mode_expire_time

Timestamp

सिर्फ़ आउटपुट के लिए. वह समय जब इंपोर्ट मोड में रहने पर, सिस्टम स्पेस को अपने-आप मिटा देगा.

इंपोर्ट मोड में बनाए गए हर स्पेस को, इस समयसीमा के खत्म होने से पहले spaces.completeImport का इस्तेमाल करके इस मोड से बाहर निकलना होगा.

यह फ़ील्ड सिर्फ़ उन स्पेस के लिए भरा जाता है जिन्हें इंपोर्ट मोड का इस्तेमाल करके बनाया गया था.

customer

string

ज़रूरी नहीं. इम्यूटेबल. स्पेस के डोमेन का ग्राहक आईडी. इसकी ज़रूरत सिर्फ़ तब होती है, जब ऐप्लिकेशन की पुष्टि करने की सुविधा के साथ कोई स्पेस बनाया जा रहा हो और SpaceType SPACE हो. ऐसा न होने पर, इसे सेट नहीं किया जाना चाहिए.

यह customers/{customer} फ़ॉर्मैट में होता है. यहां customer, Admin SDK customer resource का id होता है. प्राइवेट ऐप्लिकेशन भी customers/my_customer उपनाम का इस्तेमाल करके, ऐप्लिकेशन के Google Workspace संगठन में स्पेस बना सकते हैं.

यह फ़ील्ड, डायरेक्ट मैसेज (डीएम) के लिए नहीं भरा जाता. साथ ही, इसे तब भी नहीं भरा जाता, जब स्पेस को Google Workspace का इस्तेमाल न करने वाले लोग बनाते हैं.

यूनियन फ़ील्ड space_permission_settings. इससे किसी स्पेस की अनुमति की सेटिंग के बारे में पता चलता है. यह फ़ील्ड तब ही दिखता है, जब space_type SPACE पर सेट हो. space_permission_settings इनमें से सिर्फ़ एक हो सकता है:
predefined_permission_settings

PredefinedPermissionSettings

ज़रूरी नहीं. सिर्फ़ इनपुट के लिए. स्पेस के लिए अनुमतियों की पहले से तय की गई सेटिंग. इन्हें सिर्फ़ स्पेस बनाते समय डाला जा सकता है. अगर इस फ़ील्ड को सेट नहीं किया गया है, तो साथ मिलकर काम करने के लिए एक स्पेस बनाया जाता है. स्पेस बनाने के बाद, सेटिंग PermissionSettings फ़ील्ड में अपने-आप भर जाती हैं.

अनुमति की पहले से तय की गई सेटिंग के साथ ये काम किए जा सकते हैं:

permission_settings

PermissionSettings

ज़रूरी नहीं. मौजूदा स्पेस के लिए, स्पेस की अनुमति की सेटिंग. स्पेस की अनुमतियों की सेटिंग को अपडेट करने के लिए इनपुट. इसमें, अनुमतियों की मौजूदा सेटिंग बदल दी जाती हैं. इससे अनुमति की मौजूदा सेटिंग की सूची दिखती है.

अनुमति की सेटिंग को पढ़ने और अपडेट करने की सुविधा इनके साथ काम करती है:

AccessSettings

इससे स्पेस की ऐक्सेस सेटिंग के बारे में पता चलता है.

फ़ील्ड
access_state

AccessState

सिर्फ़ आउटपुट के लिए. इससे स्पेस के ऐक्सेस की स्थिति के बारे में पता चलता है.

audience

string

ज़रूरी नहीं. टारगेट ऑडियंस का संसाधन नाम. यह वह ऑडियंस होती है जो स्पेस को ढूंढ सकती है, उसमें शामिल हो सकती है, और उसमें मौजूद मैसेज की झलक देख सकती है. अगर यह विकल्प सेट नहीं किया जाता है, तो सिर्फ़ वे उपयोगकर्ता या Google ग्रुप स्पेस को ऐक्सेस कर सकते हैं जिन्हें स्पेस में शामिल होने का न्योता दिया गया है या जोड़ा गया है. ज़्यादा जानकारी के लिए, किसी स्पेस को टारगेट ऑडियंस के लिए खोजे जाने लायक बनाना लेख पढ़ें.

फ़ॉर्मैट: audiences/{audience}

Google Workspace संगठन के लिए डिफ़ॉल्ट टारगेट ऑडियंस का इस्तेमाल करने के लिए, इसे audiences/default पर सेट करें.

टारगेट ऑडियंस की जानकारी पढ़ने से ये काम किए जा सकते हैं:

ऐप्लिकेशन की पुष्टि के साथ chat.bot स्कोप का इस्तेमाल करने पर, इस फ़ील्ड में जानकारी अपने-आप नहीं भरती.

टारगेट ऑडियंस सेट करने के लिए, उपयोगकर्ता की पुष्टि करना ज़रूरी है.

AccessState

इससे स्पेस के ऐक्सेस की स्थिति के बारे में पता चलता है.

Enums
ACCESS_STATE_UNSPECIFIED ऐक्सेस की स्थिति के बारे में जानकारी नहीं है या यह इस एपीआई में काम नहीं करती.
PRIVATE सिर्फ़ वे उपयोगकर्ता या Google ग्रुप स्पेस को ढूंढकर ऐक्सेस कर सकते हैं जिन्हें अन्य उपयोगकर्ताओं या Google Workspace एडमिन ने स्पेस में जोड़ा है या उसमें शामिल होने का न्योता भेजा है.
DISCOVERABLE

स्पेस मैनेजर ने टारगेट ऑडियंस को स्पेस का ऐक्सेस दिया हो. जिन उपयोगकर्ताओं या Google ग्रुप को स्पेस में अलग-अलग तौर पर जोड़ा गया है या शामिल होने का न्योता दिया गया है वे भी स्पेस को ढूंढ सकते हैं और उसे ऐक्सेस कर सकते हैं. ज़्यादा जानने के लिए, स्पेस को कुछ उपयोगकर्ताओं के लिए खोजे जाने की सुविधा चालू करना लेख पढ़ें.

संगठन के सभी सदस्यों के लिए स्पेस बनाने के लिए, उपयोगकर्ता की पुष्टि करना ज़रूरी है.

MembershipCount

यह स्पेस की सदस्यताओं की संख्या दिखाता है. इन्हें कैटगरी के हिसाब से ग्रुप किया जाता है.

फ़ील्ड
joined_direct_human_user_count

int32

सिर्फ़ आउटपुट के लिए. उन उपयोगकर्ताओं की संख्या जो सीधे तौर पर स्पेस में शामिल हुए हैं. इसमें उन उपयोगकर्ताओं को शामिल नहीं किया जाता जो किसी ग्रुप की सदस्यता लेकर स्पेस में शामिल हुए हैं.

joined_group_count

int32

सिर्फ़ आउटपुट. स्पेस में सीधे तौर पर शामिल हुए सभी ग्रुप की संख्या.

PermissionSetting

यह स्पेस की अनुमति की सेटिंग को दिखाता है.

फ़ील्ड
managers_allowed

bool

ज़रूरी नहीं. स्पेस के मालिकों (ROLE_MANAGER) के पास यह अनुमति है या नहीं.

members_allowed

bool

ज़रूरी नहीं. क्या स्पेस के सामान्य सदस्यों (ROLE_MEMBER) के पास यह अनुमति है.

assistant_managers_allowed

bool

ज़रूरी नहीं. स्पेस मैनेजर ROLE_ASSISTANT_MANAGER) के पास यह अनुमति है या नहीं.

PermissionSettings

अनुमति की सेटिंग, जिन्हें नाम वाले मौजूदा स्पेस को अपडेट करते समय सेट किया जा सकता है.

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

फ़ील्ड
manage_members_and_groups

PermissionSetting

ज़रूरी नहीं. स्पेस में सदस्यों और ग्रुप को मैनेज करने की सेटिंग.

modify_space_details

PermissionSetting

ज़रूरी नहीं. स्पेस का नाम, अवतार, ब्यौरा, और दिशा-निर्देश अपडेट करने की सेटिंग.

toggle_history

PermissionSetting

ज़रूरी नहीं. स्पेस के इतिहास को चालू और बंद करने के लिए सेटिंग.

use_at_mention_all

PermissionSetting

ज़रूरी नहीं. स्पेस में @all का इस्तेमाल करने की सेटिंग.

manage_apps

PermissionSetting

ज़रूरी नहीं. किसी स्पेस में ऐप्लिकेशन मैनेज करने की सेटिंग.

manage_webhooks

PermissionSetting

ज़रूरी नहीं. किसी स्पेस में वेबहुक मैनेज करने की सेटिंग.

post_messages

PermissionSetting

सिर्फ़ आउटपुट के लिए. स्पेस में मैसेज पोस्ट करने की सेटिंग.

reply_messages

PermissionSetting

ज़रूरी नहीं. स्पेस में मैसेज का जवाब देने की सेटिंग.

PredefinedPermissionSettings

अनुमति से जुड़ी पहले से तय की गई सेटिंग. इन्हें सिर्फ़ नामित स्पेस बनाते समय तय किया जा सकता है. आने वाले समय में, इसमें और सेटिंग जोड़ी जा सकती हैं. नाम वाले स्पेस के लिए अनुमति की सेटिंग के बारे में जानने के लिए, स्पेस के बारे में जानकारी लेख पढ़ें.

Enums
PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED नहीं बताया गया है इसका इस्तेमाल न करें.
COLLABORATION_SPACE इस सेटिंग की मदद से, स्पेस को ऐसा स्पेस बनाया जा सकता है जहां सभी सदस्य मैसेज पोस्ट कर सकें.
ANNOUNCEMENT_SPACE इस सेटिंग की मदद से, स्पेस को सूचना ब्रॉडकास्ट करने वाले स्पेस के तौर पर सेट किया जा सकता है. इसमें सिर्फ़ स्पेस मैनेजर ही मैसेज पोस्ट कर सकते हैं.

SpaceDetails

स्पेस के बारे में जानकारी, जिसमें स्पेस का ब्यौरा और नियम शामिल हैं.

फ़ील्ड
description

string

ज़रूरी नहीं. स्पेस के बारे में जानकारी. उदाहरण के लिए, स्पेस में चर्चा के विषय, स्पेस के मकसद या उसमें शामिल लोगों के बारे में जानकारी दें.

इसमें ज़्यादा से ज़्यादा 150 वर्ण इस्तेमाल किए जा सकते हैं.

guidelines

string

ज़रूरी नहीं. स्पेस के नियम, उम्मीदें, और शिष्टाचार.

इसमें ज़्यादा से ज़्यादा 5,000 वर्ण हो सकते हैं.

SpaceThreadingState

इससे Chat स्पेस में थ्रेडिंग की स्थिति का पता चलता है.

Enums
SPACE_THREADING_STATE_UNSPECIFIED रिज़र्व किया गया.
THREADED_MESSAGES ऐसे स्पेस जिनमें मैसेज थ्रेड की सुविधा काम करती हो. जब उपयोगकर्ता किसी मैसेज का जवाब देते हैं, तो वे थ्रेड में जवाब दे सकते हैं. इससे उनका जवाब, ओरिजनल मैसेज के कॉन्टेक्स्ट में रहता है.
GROUPED_MESSAGES नाम वाले स्पेस, जहां बातचीत को विषय के हिसाब से व्यवस्थित किया जाता है. विषयों और उनके जवाबों को एक साथ ग्रुप किया जाता है.
UNTHREADED_MESSAGES

ऐसे स्पेस जिनमें मैसेज थ्रेडिंग की सुविधा काम नहीं करती. इस स्पेस थ्रेडिंग की स्थिति का इस्तेमाल सिर्फ़ खास मामलों के लिए किया जाता है. जैसे:

  • मीटिंग के स्पेस में लगातार चैट करने की सुविधा, जिसमें थ्रेड बनाने की सुविधा को जान-बूझकर बंद किया गया हो.
  • साल 2022 से पहले शुरू की गई लेगसी ग्रुप बातचीत.

SpaceType

स्पेस किस तरह का है. स्पेस बनाते या अपडेट करते समय यह फ़ील्ड ज़रूरी होता है. सिर्फ़ आउटपुट के लिए.

Enums
SPACE_TYPE_UNSPECIFIED रिज़र्व किया गया.
SPACE यह एक ऐसी जगह है जहां लोग मैसेज भेजते हैं, फ़ाइलें शेयर करते हैं, और साथ मिलकर काम करते हैं. SPACE में Chat ऐप्लिकेशन शामिल किए जा सकते हैं.
GROUP_CHAT तीन या उससे ज़्यादा लोगों के बीच ग्रुप बातचीत. GROUP_CHAT में Chat ऐप्लिकेशन शामिल किए जा सकते हैं.
DIRECT_MESSAGE दो लोगों के बीच या किसी व्यक्ति और Chat ऐप्लिकेशन के बीच हुए 1:1 मैसेज.

टाइप

इस्तेमाल बंद कर दिया गया है: इसके बजाय, SpaceType का इस्तेमाल करें.

Enums
TYPE_UNSPECIFIED रिज़र्व किया गया.
ROOM दो या उससे ज़्यादा इंसानों के बीच बातचीत.
DM किसी इंसान और चैट ऐप्लिकेशन के बीच की गई सीधी बातचीत, जिसमें सभी मैसेज फ़्लैट हैं. ध्यान दें कि इसमें दो इंसानों के बीच की गई सीधी बातचीत शामिल नहीं है.

SpaceBatchUpdatedEventData

किसी स्पेस में कई अपडेट के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.space.v1.batchUpdated

फ़ील्ड
spaces[]

SpaceUpdatedEventData

अपडेट किए गए स्पेस की सूची.

SpaceEvent

यह एक ऐसा इवेंट है जो Google Chat स्पेस में हुए बदलाव या गतिविधि को दिखाता है. ज़्यादा जानने के लिए, Google Chat के इवेंट इस्तेमाल करना लेख पढ़ें.

फ़ील्ड
name

string

स्पेस इवेंट के रिसॉर्स का नाम.

फ़ॉर्मैट: spaces/{space}/spaceEvents/{spaceEvent}

event_time

Timestamp

इवेंट होने का समय.

event_type

string

स्पेस इवेंट का टाइप. हर इवेंट टाइप का एक बैच वर्शन होता है. इससे इवेंट टाइप के उन कई इंस्टेंस के बारे में पता चलता है जो कम समय में होते हैं. spaceEvents.list() अनुरोधों के लिए, अपनी क्वेरी फ़िल्टर में बैच इवेंट टाइप शामिल न करें. डिफ़ॉल्ट रूप से, सर्वर इवेंट टाइप और उसके बैच वर्शन, दोनों को दिखाता है.

मैसेज के लिए, इन इवेंट टाइप का इस्तेमाल किया जा सकता है:

  • नया मैसेज: google.workspace.chat.message.v1.created
  • अपडेट किया गया मैसेज: google.workspace.chat.message.v1.updated
  • मिटाया गया मैसेज: google.workspace.chat.message.v1.deleted
  • एक से ज़्यादा नए मैसेज: google.workspace.chat.message.v1.batchCreated
  • अपडेट किए गए कई मैसेज: google.workspace.chat.message.v1.batchUpdated
  • एक से ज़्यादा मिटाए गए मैसेज: google.workspace.chat.message.v1.batchDeleted

पैसे चुकाकर ली जाने वाली सदस्यताओं के लिए, इन इवेंट टाइप का इस्तेमाल किया जा सकता है:

  • नई सदस्यता: google.workspace.chat.membership.v1.created
  • अपडेट की गई सदस्यता: google.workspace.chat.membership.v1.updated
  • हटाई गई सदस्यता: google.workspace.chat.membership.v1.deleted
  • पैसे चुकाकर ली गई नई सदस्यताएं: google.workspace.chat.membership.v1.batchCreated
  • अपग्रेड की गई एक से ज़्यादा सदस्यताएं: google.workspace.chat.membership.v1.batchUpdated
  • पैसे चुकाकर ली गई कई सदस्यताएं मिटाई गईं: google.workspace.chat.membership.v1.batchDeleted

प्रतिक्रियाओं के लिए, इन इवेंट टाइप का इस्तेमाल किया जा सकता है:

  • नई प्रतिक्रिया: google.workspace.chat.reaction.v1.created
  • प्रतिक्रिया मिटाई गई: google.workspace.chat.reaction.v1.deleted
  • एक से ज़्यादा नई प्रतिक्रियाएं: google.workspace.chat.reaction.v1.batchCreated
  • एक से ज़्यादा प्रतिक्रियाएं मिटाई गईं: google.workspace.chat.reaction.v1.batchDeleted

स्पेस के बारे में इन इवेंट टाइप का इस्तेमाल किया जा सकता है:

  • अपडेट किया गया स्पेस: google.workspace.chat.space.v1.updated
  • एक से ज़्यादा स्पेस के अपडेट: google.workspace.chat.space.v1.batchUpdated

यूनियन फ़ील्ड payload.

payload इनमें से सिर्फ़ एक हो सकता है:

message_created_event_data

MessageCreatedEventData

नए मैसेज के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.message.v1.created

message_updated_event_data

MessageUpdatedEventData

अपडेट किए गए मैसेज के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.message.v1.updated

message_deleted_event_data

MessageDeletedEventData

मिटाए गए मैसेज के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.message.v1.deleted

message_batch_created_event_data

MessageBatchCreatedEventData

एक से ज़्यादा नए मैसेज के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.message.v1.batchCreated

message_batch_updated_event_data

MessageBatchUpdatedEventData

अपडेट किए गए कई मैसेज के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.message.v1.batchUpdated

message_batch_deleted_event_data

MessageBatchDeletedEventData

मिटाए गए कई मैसेज के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.message.v1.batchDeleted

space_updated_event_data

SpaceUpdatedEventData

स्पेस अपडेट के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.space.v1.updated

space_batch_updated_event_data

SpaceBatchUpdatedEventData

किसी स्पेस में कई अपडेट के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.space.v1.batchUpdated

membership_created_event_data

MembershipCreatedEventData

नई सदस्यता के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.membership.v1.created

membership_updated_event_data

MembershipUpdatedEventData

अपडेट की गई सदस्यता के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.membership.v1.updated

membership_deleted_event_data

MembershipDeletedEventData

मिटाई गई सदस्यता के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.membership.v1.deleted

membership_batch_created_event_data

MembershipBatchCreatedEventData

एक से ज़्यादा नई सदस्यताओं के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.membership.v1.batchCreated

membership_batch_updated_event_data

MembershipBatchUpdatedEventData

अपडेट की गई एक से ज़्यादा सदस्यताओं के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.membership.v1.batchUpdated

membership_batch_deleted_event_data

MembershipBatchDeletedEventData

मिटाई गई एक से ज़्यादा सदस्यताओं के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.membership.v1.batchDeleted

reaction_created_event_data

ReactionCreatedEventData

नई प्रतिक्रिया के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.reaction.v1.created

reaction_deleted_event_data

ReactionDeletedEventData

मिटाई गई प्रतिक्रिया के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.reaction.v1.deleted

reaction_batch_created_event_data

ReactionBatchCreatedEventData

एक से ज़्यादा नई प्रतिक्रियाओं के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.reaction.v1.batchCreated

reaction_batch_deleted_event_data

ReactionBatchDeletedEventData

मिटाई गई कई प्रतिक्रियाओं के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.reaction.v1.batchDeleted

SpaceNotificationSetting

किसी स्पेस में मौजूद उपयोगकर्ता की सूचना सेटिंग.

फ़ील्ड
name

string

आइडेंटिफ़ायर. स्पेस की सूचना सेटिंग का संसाधन नाम. फ़ॉर्मैट: users/{user}/spaces/{space}/spaceNotificationSetting.

notification_setting

NotificationSetting

सूचना सेटिंग.

mute_setting

MuteSetting

स्पेस की सूचनाएं म्यूट करने की सेटिंग.

MuteSetting

स्पेस की सूचनाओं को म्यूट करने की सेटिंग के टाइप.

Enums
MUTE_SETTING_UNSPECIFIED रिज़र्व किया गया.
UNMUTED उपयोगकर्ता को सूचना सेटिंग के आधार पर, स्पेस के लिए सूचनाएं मिलेंगी.
MUTED उपयोगकर्ता को स्पेस के लिए कोई सूचना नहीं मिलेगी. भले ही, सूचना सेटिंग कुछ भी हो.

NotificationSetting

सूचना सेटिंग के टाइप. आने वाले समय में, अन्य टाइप के डेटा को भी माइग्रेट किया जा सकेगा.

Enums
NOTIFICATION_SETTING_UNSPECIFIED रिज़र्व किया गया.
ALL सूचनाएं तब ट्रिगर होती हैं, जब आपका नाम टैग किया जाता है, फ़ॉलो की गई थ्रेड में कोई नया मैसेज आता है या नई थ्रेड का पहला मैसेज आता है. सभी नई थ्रेड अपने-आप फ़ॉलो हो जाती हैं. हालांकि, उपयोगकर्ता के पास इन्हें मैन्युअल तरीके से अनफ़ॉलो करने का विकल्प होता है.
MAIN_CONVERSATIONS सूचनाएं, नाम टैग किए जाने, फ़ॉलो की गई थ्रेड या नई थ्रेड के पहले मैसेज के लिए ट्रिगर होती हैं. यह सुविधा, किसी व्यक्ति को भेजे गए डायरेक्ट मैसेज के लिए उपलब्ध नहीं है.
FOR_YOU सूचनाएं, टैग किए गए नाम और फ़ॉलो की गई थ्रेड के लिए ट्रिगर होती हैं. यह सुविधा, किसी व्यक्ति को भेजे गए डायरेक्ट मैसेज के लिए उपलब्ध नहीं है.
OFF सूचनाएं पाने की सुविधा बंद है.

SpaceReadState

किसी स्पेस में उपयोगकर्ता के लिए मैसेज के पढ़े जाने की स्थिति. इसका इस्तेमाल, पढ़े गए और नहीं पढ़े गए मैसेज की पहचान करने के लिए किया जाता है.

फ़ील्ड
name

string

स्पेस को पढ़ने की स्थिति के संसाधन का नाम.

फ़ॉर्मैट: users/{user}/spaces/{space}/spaceReadState

last_read_time

Timestamp

ज़रूरी नहीं. वह समय जब उपयोगकर्ता के स्पेस को पढ़े जाने की स्थिति को अपडेट किया गया था. आम तौर पर, यह आखिरी बार पढ़े गए मैसेज के टाइमस्टैंप या उपयोगकर्ता की ओर से तय किए गए टाइमस्टैंप से मेल खाता है. इस टाइमस्टैंप का इस्तेमाल, स्पेस में आखिरी बार पढ़े गए मैसेज की जगह को मार्क करने के लिए किया जाता है.

SpaceUpdatedEventData

अपडेट किए गए स्पेस के लिए इवेंट पेलोड.

इवेंट का टाइप: google.workspace.chat.space.v1.updated

फ़ील्ड
space

Space

अपडेट किया गया स्पेस.

SpaceView

यह एक ऐसा व्यू है जो यह तय करता है कि Space संसाधन में किन फ़ील्ड को पॉप्युलेट किया जाना चाहिए. हमारा सुझाव है कि आपका कोड अतिरिक्त वैल्यू के साथ काम करे, ताकि आने वाले समय में रिलीज़ होने वाले वर्शन के साथ काम कर सके.

Enums
SPACE_VIEW_UNSPECIFIED डिफ़ॉल्ट / सेट नहीं की गई वैल्यू.
SPACE_VIEW_RESOURCE_NAME_ONLY इससे सिर्फ़ स्पेस के संसाधन का नाम भरता है.
SPACE_VIEW_EXPANDED स्पेस संसाधन के फ़ील्ड भरता है. ध्यान दें: permissionSettings फ़ील्ड में वैल्यू नहीं भरी जाएगी. SPACE_VIEW_EXPANDED के बारे में बताने वाले अनुरोधों में, ऐसे स्कोप शामिल होने चाहिए जिनसे स्पेस का डेटा पढ़ा जा सके. उदाहरण के लिए, https://www.googleapis.com/auth/chat.spaces या https://www.googleapis.com/auth/chat.spaces.readonly.

थ्रेड

Google Chat स्पेस में मौजूद थ्रेड. इसके इस्तेमाल का उदाहरण देखने के लिए, मैसेज थ्रेड शुरू करना या उसका जवाब देना लेख पढ़ें.

मैसेज बनाते समय थ्रेड तय करने पर, messageReplyOption फ़ील्ड सेट किया जा सकता है. इससे यह तय किया जा सकता है कि मिलती-जुलती थ्रेड न मिलने पर क्या होगा.

फ़ील्ड
name

string

आइडेंटिफ़ायर. थ्रेड का संसाधन नाम.

उदाहरण: spaces/{space}/threads/{thread}

thread_key

string

ज़रूरी नहीं. थ्रेड बनाने या अपडेट करने के लिए इनपुट. इसके अलावा, सिर्फ़ आउटपुट. थ्रेड का आईडी. इसमें ज़्यादा से ज़्यादा 4,000 वर्ण इस्तेमाल किए जा सकते हैं.

यह आईडी, Chat ऐप्लिकेशन के लिए यूनीक होता है. उदाहरण के लिए, अगर कई Chat ऐप्लिकेशन एक ही थ्रेड कुंजी का इस्तेमाल करके कोई मैसेज बनाते हैं, तो मैसेज अलग-अलग थ्रेड में पोस्ट किए जाते हैं. अगर आपको किसी व्यक्ति या दूसरे Chat ऐप्लिकेशन की बनाई गई थ्रेड में जवाब देना है, तो थ्रेड name फ़ील्ड का इस्तेमाल करें.

ThreadReadState

इस कुकी का इस्तेमाल, थ्रेड में उपयोगकर्ता की 'पढ़ी गई' स्थिति को सेव करने के लिए किया जाता है. इससे यह पता चलता है कि कौनसे मैसेज पढ़े गए हैं और कौनसे नहीं.

फ़ील्ड
name

string

थ्रेड के पढ़े जाने की स्थिति के संसाधन का नाम.

फ़ॉर्मैट: users/{user}/spaces/{space}/threads/{thread}/threadReadState

last_read_time

Timestamp

वह समय जब उपयोगकर्ता के थ्रेड को पढ़े जाने की स्थिति को अपडेट किया गया था. आम तौर पर, यह थ्रेड में पढ़े गए आखिरी मैसेज के टाइमस्टैंप से मेल खाता है.

UpdateMembershipRequest

सदस्यता अपडेट करने के लिए अनुरोध मैसेज.

फ़ील्ड
membership

Membership

ज़रूरी है. अपडेट की जाने वाली सदस्यता. सिर्फ़ update_mask से तय किए गए फ़ील्ड अपडेट किए जाते हैं.

update_mask

FieldMask

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

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

  • role
use_admin_access

bool

ज़रूरी नहीं. जब true होता है, तो यह तरीका उपयोगकर्ता के Google Workspace एडमिन के अधिकारों का इस्तेमाल करके काम करता है.

कॉल करने वाला व्यक्ति, Google Workspace एडमिन होना चाहिए. साथ ही, उसके पास चैट और स्पेस में होने वाली बातचीत को मैनेज करने का अधिकार होना चाहिए.

इसके लिए, chat.admin.memberships OAuth 2.0 स्कोप की ज़रूरत होती है.

UpdateMessageRequest

मैसेज अपडेट करने का अनुरोध करना.

फ़ील्ड
message

Message

ज़रूरी है. ऐसे मैसेज जिनके फ़ील्ड अपडेट किए गए हैं.

update_mask

FieldMask

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

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

allow_missing

bool

ज़रूरी नहीं. अगर true और मैसेज नहीं मिलता है, तो एक नया मैसेज बनाया जाता है और updateMask को अनदेखा कर दिया जाता है. दिया गया मैसेज आईडी, क्लाइंट की ओर से असाइन किया गया होना चाहिए. ऐसा न होने पर, अनुरोध पूरा नहीं होगा.

UpdateSectionRequest

किसी सेक्शन को अपडेट करने के लिए अनुरोध मैसेज.

फ़ील्ड
section

Section

ज़रूरी है. अपडेट किया जाने वाला सेक्शन.

update_mask

FieldMask

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

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

  • display_name

UpdateSpaceNotificationSettingRequest

स्पेस की सूचना सेटिंग अपडेट करने का अनुरोध. सिर्फ़ कॉल करने वाले व्यक्ति के लिए सूचना सेटिंग अपडेट करने की सुविधा उपलब्ध है.

फ़ील्ड
space_notification_setting

SpaceNotificationSetting

ज़रूरी है. स्पेस की सूचना सेटिंग के लिए संसाधन का नाम, users/{user}/spaces/{space}/spaceNotificationSetting के फ़ॉर्मैट में होना चाहिए. सिर्फ़ update_mask से तय किए गए फ़ील्ड अपडेट किए जाते हैं.

update_mask

FieldMask

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

  • notification_setting

  • mute_setting

UpdateSpaceReadStateRequest

UpdateSpaceReadState API के लिए अनुरोध का मैसेज.

फ़ील्ड
space_read_state

SpaceReadState

ज़रूरी है. स्पेस के पढ़े जाने की स्थिति और अपडेट किए जाने वाले फ़ील्ड.

इससे सिर्फ़ कॉल करने वाले व्यक्ति के लिए, पढ़े जाने की स्थिति को अपडेट किया जा सकता है.

कॉल करने वाले उपयोगकर्ता को रेफ़र करने के लिए, इनमें से कोई एक विकल्प सेट करें:

  • me का दूसरा ईमेल पता. उदाहरण के लिए, users/me/spaces/{space}/spaceReadState.

  • उनका Workspace ईमेल पता. उदाहरण के लिए, users/user@example.com/spaces/{space}/spaceReadState.

  • उनका यूज़र आईडी. उदाहरण के लिए, users/123456789/spaces/{space}/spaceReadState.

फ़ॉर्मैट: users/{user}/spaces/{space}/spaceReadState

update_mask

FieldMask

ज़रूरी है. अपडेट करने के लिए फ़ील्ड पाथ. फ़िलहाल, इन फ़ील्ड पाथ का इस्तेमाल किया जा सकता है:

  • last_read_time

अगर last_read_time, मैसेज बनाने के सबसे नए समय से पहले का है, तो स्पेस को यूज़र इंटरफ़ेस (यूआई) में 'नहीं पढ़ा गया' के तौर पर दिखाया जाता है.

स्पेस को 'पढ़ा गया' के तौर पर मार्क करने के लिए, last_read_time को बाद में (ज़्यादा) किसी भी वैल्यू पर सेट करें. यह वैल्यू, सबसे नए मैसेज के क्रिएट होने के समय से ज़्यादा होनी चाहिए. last_read_time को सबसे नए मैसेज के क्रिएट होने के समय के हिसाब से सेट किया जाता है. ध्यान दें कि स्पेस के 'पढ़ा गया' के तौर पर मार्क होने का असर सिर्फ़ उन मैसेज पर पड़ता है जो स्पेस की टॉप-लेवल बातचीत में दिखते हैं. थ्रेड में मौजूद जवाबों पर इस टाइमस्टैंप का कोई असर नहीं पड़ता. इसके बजाय, ये थ्रेड के 'पढ़ा गया' के तौर पर मार्क होने की स्थिति पर निर्भर करते हैं.

UpdateSpaceRequest

किसी एक स्पेस को अपडेट करने का अनुरोध.

फ़ील्ड
space

Space

ज़रूरी है. वह स्पेस जिसमें फ़ील्ड अपडेट किए जाने हैं. Space.name को spaces/{space} के तौर पर भरा जाना चाहिए. सिर्फ़ update_mask से तय किए गए फ़ील्ड अपडेट किए जाते हैं.

update_mask

FieldMask

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

किसी स्पेस के लिए, इन फ़ील्ड को अपडेट किया जा सकता है:

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

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

space_type: सिर्फ़ GROUP_CHAT स्पेस टाइप को SPACE में बदला जा सकता है. अपडेट मास्क में space_type के साथ display_name को शामिल करें. साथ ही, पक्का करें कि तय की गई जगह का डिसप्ले नेम खाली न हो और वह SPACE स्पेस टाइप का हो. डिसप्ले नेम अपडेट करते समय, तय किए गए स्पेस में space_type मास्क और SPACE टाइप शामिल करना ज़रूरी नहीं है. ऐसा तब होता है, जब मौजूदा स्पेस में पहले से ही SPACE टाइप मौजूद हो. स्पेस के टाइप को अपडेट करने के अन्य तरीकों से, अमान्य तर्क से जुड़ी गड़बड़ी होती है. useAdminAccess के साथ space_type का इस्तेमाल नहीं किया जा सकता.

space_history_state: स्पेस के लिए, इतिहास की सुविधा चालू या बंद करके, स्पेस के इतिहास की सेटिंग अपडेट करता है. इस सुविधा का इस्तेमाल सिर्फ़ तब किया जा सकता है, जब Google Workspace संगठन के लिए इतिहास की सेटिंग चालू हों. स्पेस के इतिहास की स्थिति को अपडेट करने के लिए, आपको अपने अनुरोध में अन्य सभी फ़ील्ड मास्क हटाने होंगे. useAdminAccess के साथ space_history_state का इस्तेमाल नहीं किया जा सकता.

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

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

  • permission_settings.manageMembersAndGroups
  • permission_settings.modifySpaceDetails
  • permission_settings.toggleHistory
  • permission_settings.useAtMentionAll
  • permission_settings.manageApps
  • permission_settings.manageWebhooks
  • permission_settings.replyMessages
use_admin_access

bool

ज़रूरी नहीं. जब true होता है, तो यह तरीका उपयोगकर्ता के Google Workspace एडमिन के अधिकारों का इस्तेमाल करके काम करता है.

कॉल करने वाला व्यक्ति, Google Workspace एडमिन होना चाहिए. साथ ही, उसके पास चैट और स्पेस में होने वाली बातचीत को मैनेज करने का अधिकार होना चाहिए.

इसके लिए, chat.admin.spaces OAuth 2.0 स्कोप की ज़रूरत होती है.

एडमिन ऐक्सेस का इस्तेमाल करके, FieldMask की कुछ वैल्यू सेट नहीं की जा सकतीं. ज़्यादा जानकारी के लिए, update_mask का ब्यौरा देखें.

उपयोगकर्ता

Google Chat का कोई उपयोगकर्ता. अगर आपका Chat ऐप्लिकेशन, अनुरोध के आउटपुट के तौर पर उपयोगकर्ता के तौर पर पुष्टि करता है, तो User संसाधन का आउटपुट सिर्फ़ उपयोगकर्ता के name और type को दिखाता है.

फ़ील्ड
name

string

Google Chat user के लिए संसाधन का नाम.

फ़ॉर्मैट: users/{user}. users/app का इस्तेमाल, कॉलिंग ऐप्लिकेशन bot के उपयोगकर्ता के लिए एलियास के तौर पर किया जा सकता है.

human users के लिए, {user} वही यूज़र आइडेंटिफ़ायर है जो:

  • People API में व्यक्ति के लिए id. उदाहरण के लिए, Chat API में users/123456789, People API में 123456789 व्यक्ति की प्रोफ़ाइल आईडी के तौर पर एक ही व्यक्ति को दिखाता है.

  • Admin SDK Directory API में मौजूद उपयोगकर्ता के लिए id.

  • एपीआई अनुरोधों में, उपयोगकर्ता के ईमेल पते का इस्तेमाल {user} के लिए एलियास के तौर पर किया जा सकता है. उदाहरण के लिए, अगर People API में user@example.com के लिए व्यक्ति की प्रोफ़ाइल का आईडी 123456789 है, तो users/123456789 को रेफ़रंस देने के लिए, users/user@example.com का इस्तेमाल एलियास के तौर पर किया जा सकता है. एपीआई से सिर्फ़ कैननिकल रिसॉर्स का नाम (उदाहरण के लिए, users/123456789) दिखेगा.

display_name

string

सिर्फ़ आउटपुट के लिए. उपयोगकर्ता का डिसप्ले नेम.

domain_id

string

उपयोगकर्ता के Google Workspace डोमेन का यूनीक आइडेंटिफ़ायर.

type

Type

उपयोगकर्ता का टाइप.

is_anonymous

bool

सिर्फ़ आउटपुट के लिए. जब true, उपयोगकर्ता का खाता मिटा दिया जाता है या उसकी प्रोफ़ाइल नहीं दिखती है.

टाइप

Enums
TYPE_UNSPECIFIED enum के लिए डिफ़ॉल्ट वैल्यू. इसका इस्तेमाल न करें.
HUMAN कोई इंसान.
BOT Chat ऐप्लिकेशन का इस्तेमाल करने वाला व्यक्ति.

UserMentionMetadata

उपयोगकर्ता के नाम (@) के लिए एनोटेशन मेटाडेटा.

फ़ील्ड
user

User

जिस उपयोगकर्ता का ज़िक्र किया गया है.

type

Type

उपयोगकर्ता को टैग करने का टाइप.

टाइप

Enums
TYPE_UNSPECIFIED इनम की डिफ़ॉल्ट वैल्यू. इसका इस्तेमाल न करें.
ADD स्पेस में उपयोगकर्ता को जोड़ें.
MENTION स्पेस में किसी उपयोगकर्ता का नाम टैग करें.

WidgetMarkup

विजेट, यूज़र इंटरफ़ेस (यूआई) का एक एलिमेंट होता है. यह टेक्स्ट और इमेज दिखाता है.

फ़ील्ड
buttons[]

Button

बटन की सूची. बटन भी oneof data है और इनमें से सिर्फ़ एक फ़ील्ड सेट किया जाना चाहिए.

यूनियन फ़ील्ड data. WidgetMarkup में इनमें से सिर्फ़ एक आइटम हो सकता है. ज़्यादा आइटम दिखाने के लिए, एक से ज़्यादा WidgetMarkup फ़ील्ड का इस्तेमाल किया जा सकता है. data इनमें से सिर्फ़ एक हो सकता है:
text_paragraph

TextParagraph

इस विजेट में टेक्स्ट पैराग्राफ़ दिखाएं.

image

Image

इस विजेट में कोई इमेज दिखाएं.

key_value

KeyValue

इस विजेट में मुख्य वैल्यू वाला आइटम दिखाएं.

बटन

बटन. यह टेक्स्ट बटन या इमेज बटन हो सकता है.

फ़ील्ड

यूनियन फ़ील्ड type.

type इनमें से सिर्फ़ एक हो सकता है:

text_button

TextButton

टेक्स्ट और onclick ऐक्शन वाला बटन.

image_button

ImageButton

इमेज और onclick ऐक्शन वाला बटन.

FormAction

फ़ॉर्म ऐक्शन से पता चलता है कि फ़ॉर्म सबमिट होने पर क्या होगा. उदाहरण के लिए, फ़ॉर्म को मैनेज करने के लिए Apps Script को चालू किया जा सकता है.

फ़ील्ड
action_method_name

string

मेथड के नाम का इस्तेमाल यह पता लगाने के लिए किया जाता है कि फ़ॉर्म के किस हिस्से से फ़ॉर्म सबमिट हुआ है. यह जानकारी, कार्ड क्लिक इवेंट के हिस्से के तौर पर Chat ऐप्लिकेशन को वापस भेजी जाती है. एक ही तरह का व्यवहार ट्रिगर करने वाले कई एलिमेंट के लिए, एक ही तरीके के नाम का इस्तेमाल किया जा सकता है.

parameters[]

ActionParameter

ऐक्शन पैरामीटर की सूची.

ActionParameter

कार्रवाई के तरीके को शुरू करने पर, स्ट्रिंग पैरामीटर की सूची दी जाती है. उदाहरण के लिए, स्नूज़ करने के तीन बटन देखें: अभी स्नूज़ करें, एक दिन के लिए स्नूज़ करें, अगले हफ़्ते के लिए स्नूज़ करें. स्ट्रिंग पैरामीटर की सूची में स्नूज़ करने का टाइप और स्नूज़ करने का समय पास करके, action method = snooze() का इस्तेमाल किया जा सकता है.

फ़ील्ड
key

string

ऐक्शन स्क्रिप्ट के लिए पैरामीटर का नाम.

value

string

पैरामीटर की वैल्यू.

आइकॉन

काम करने वाले आइकॉन का सेट.

Enums
ICON_UNSPECIFIED
AIRPLANE
BOOKMARK
BUS
CAR
CLOCK
CONFIRMATION_NUMBER_ICON
DOLLAR
DESCRIPTION
EMAIL
EVENT_PERFORMER
EVENT_SEAT
FLIGHT_ARRIVAL
FLIGHT_DEPARTURE
HOTEL
HOTEL_ROOM_TYPE
INVITE
MAP_PIN
MEMBERSHIP
MULTIPLE_PEOPLE
OFFER
PERSON
PHONE
RESTAURANT_ICON
SHOPPING_CART
STAR
STORE
TICKET
TRAIN
VIDEO_CAMERA
VIDEO_PLAY

इमेज

यूआरएल से तय की गई इमेज, जिसमें onclick कार्रवाई की जा सकती है.

फ़ील्ड
image_url

string

इमेज का यूआरएल.

on_click

OnClick

onclick कार्रवाई.

aspect_ratio

double

इस इमेज का आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात). इस फ़ील्ड की मदद से, इमेज लोड होने तक उसके लिए सही ऊंचाई रिज़र्व की जा सकती है. इसका मतलब यह नहीं है कि इमेज के बिल्ट-इन आसपेक्ट रेशियो को बदला जा सकता है. अगर इसे सेट नहीं किया जाता है, तो सर्वर इमेज को पहले से फ़ेच करके इसे भर देता है.

ImageButton

onclick ऐक्शन वाला इमेज बटन.

फ़ील्ड
on_click

OnClick

onclick कार्रवाई.

name

string

यह image_button का नाम है. इसका इस्तेमाल सुलभता के लिए किया जाता है. अगर यह नाम नहीं दिया गया है, तो डिफ़ॉल्ट वैल्यू दी जाती है.

यूनियन फ़ील्ड icons. आइकॉन को Icon enum या यूआरएल के तौर पर तय किया जा सकता है. icons इनमें से सिर्फ़ एक हो सकता है:
icon

Icon

enum से तय किया गया आइकॉन, जो Chat API से मिले आइकॉन को इंडेक्स करता है.

icon_url

string

यूआरएल से तय किया गया आइकॉन.

KeyValue

यूज़र इंटरफ़ेस (यूआई) एलिमेंट में एक कुंजी (लेबल) और एक वैल्यू (कॉन्टेंट) होती है. इस एलिमेंट में कुछ कार्रवाइयां भी शामिल हो सकती हैं, जैसे कि onclick बटन.

फ़ील्ड
top_label

string

सबसे ऊपर मौजूद लेबल का टेक्स्ट. फ़ॉर्मैट किए गए टेक्स्ट का इस्तेमाल किया जा सकता है. टेक्स्ट को फ़ॉर्मैट करने के बारे में ज़्यादा जानने के लिए, Google Chat ऐप्लिकेशन में टेक्स्ट को फ़ॉर्मैट करना और Google Workspace ऐड-ऑन में टेक्स्ट को फ़ॉर्मैट करना लेख पढ़ें.

content

string

कॉन्टेंट का टेक्स्ट. फ़ॉर्मैट किए गए टेक्स्ट का इस्तेमाल किया जा सकता है. यह हमेशा ज़रूरी होता है. टेक्स्ट को फ़ॉर्मैट करने के बारे में ज़्यादा जानने के लिए, Google Chat ऐप्लिकेशन में टेक्स्ट को फ़ॉर्मैट करना और Google Workspace ऐड-ऑन में टेक्स्ट को फ़ॉर्मैट करना लेख पढ़ें.

content_multiline

bool

अगर कॉन्टेंट कई लाइनों में होना चाहिए.

bottom_label

string

सबसे नीचे मौजूद लेबल का टेक्स्ट. फ़ॉर्मैट किए गए टेक्स्ट का इस्तेमाल किया जा सकता है. टेक्स्ट को फ़ॉर्मैट करने के बारे में ज़्यादा जानने के लिए, Google Chat ऐप्लिकेशन में टेक्स्ट को फ़ॉर्मैट करना और Google Workspace ऐड-ऑन में टेक्स्ट को फ़ॉर्मैट करना लेख पढ़ें.

on_click

OnClick

onclick कार्रवाई. सिर्फ़ टॉप लेबल, बॉटम लेबल, और कॉन्टेंट रीजन पर क्लिक किया जा सकता है.

यूनियन फ़ील्ड icons. आइकॉन, top_label, और bottom_label में से कम से कम एक को तय किया जाना चाहिए. icons इनमें से सिर्फ़ एक हो सकता है:
icon

Icon

यह एक इनम वैल्यू है, जिसे Chat API, उससे जुड़ी आइकॉन इमेज से बदल देता है.

icon_url

string

यूआरएल से तय किया गया आइकॉन.

यूनियन फ़ील्ड control. कंट्रोल विजेट. button या switch_widget में से किसी एक को सेट किया जा सकता है, लेकिन दोनों को नहीं. control इनमें से सिर्फ़ एक हो सकता है:
button

Button

यह एक बटन होता है, जिस पर क्लिक करके कोई कार्रवाई की जा सकती है.

OnClick

onclick कार्रवाई (उदाहरण के लिए, कोई लिंक खोलना).

फ़ील्ड

यूनियन फ़ील्ड data.

data इनमें से सिर्फ़ एक हो सकता है:

action

FormAction

अगर onclick कार्रवाई तय की गई है, तो इससे फ़ॉर्म ऐक्शन ट्रिगर होता है.

TextButton

टेक्स्ट और onclick ऐक्शन वाला बटन.

फ़ील्ड
text

string

बटन का टेक्स्ट.

on_click

OnClick

बटन की onclick कार्रवाई.

TextParagraph

टेक्स्ट का पैराग्राफ़. इसमें फ़ॉर्मैट किए गए टेक्स्ट का इस्तेमाल किया जा सकता है. टेक्स्ट को फ़ॉर्मैट करने के बारे में ज़्यादा जानने के लिए, Google Chat ऐप्लिकेशन में टेक्स्ट को फ़ॉर्मैट करना और Google Workspace ऐड-ऑन में टेक्स्ट को फ़ॉर्मैट करना लेख पढ़ें.

फ़ील्ड
text

string