Google Chat API को कॉन्फ़िगर करना

आपके बनाए गए हर Google Chat ऐप्लिकेशन के लिए, Chat API की सुविधा चालू करने वाला अपना Google Cloud प्रोजेक्ट होना चाहिए.

उपयोगकर्ता की पुष्टि के साथ, सिर्फ़ पढ़ने के लिए एपीआई कॉल करने के लिए, जैसे कि स्पेस पाना और मैसेज की सूची देखना, आपको सिर्फ़ एपीआई को चालू करना होगा और OAuth क्लाइंट बनाना होगा.

एपीआई कॉल करने के लिए, आपको Chat API को भी कॉन्फ़िगर करना होगा. इस पेज पर, Google Chat ऐप्लिकेशन सेट अप करके, Chat API को कॉन्फ़िगर करने का तरीका बताया गया है.

ज़रूरी शर्तें

अपने Chat ऐप्लिकेशन के लिए डिसप्ले नेम, अवतार, और ब्यौरा चुनना

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

Chat API को कॉन्फ़िगर करने के लिए, आपको Google Chat ऐप्लिकेशन को इस जानकारी के साथ सेट अप करना होगा:

फ़ील्ड ब्यौरा फ़ॉर्मैट
ऐप्लिकेशन का नाम Chat ऐप्लिकेशन का डिसप्ले नेम. ज़्यादा से ज़्यादा 25 अल्फ़ान्यूमेरिक वर्ण
अवतार यूआरएल वह इमेज जो आपके Chat ऐप्लिकेशन के अवतार के तौर पर दिखती है. एक HTTPS यूआरएल, जो स्क्वेयर ग्राफ़िक्स इमेज (PNG या JPEG) की ओर इशारा करता है. हमारा सुझाव है कि इमेज का साइज़ 256x256 पिक्सल या इससे ज़्यादा हो.
ब्यौरा Chat ऐप्लिकेशन के मकसद के बारे में कम शब्दों में जानकारी. ज़्यादा से ज़्यादा 40 अल्फ़ान्यूमेरिक वर्ण

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

उदाहरण के लिए, अगर spaces.create() तरीके को कॉल किया जाता है, तो Chat, स्पेस बनाने वाले व्यक्ति की जानकारी में Chat ऐप्लिकेशन का नाम शामिल करता है. यह जानकारी, यहां दी गई इमेज में दिखाई गई है:

Google Chat ऐप्लिकेशन, उपयोगकर्ता के लिए एक स्पेस बनाता है.
पहली इमेज. एट्रिब्यूशन मैसेज, जो Chat तब दिखाता है, जब किसी उपयोगकर्ता की ओर से स्पेस बनाने के लिए spaces.create() तरीके का इस्तेमाल किया जाता है.

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

  • Chat ऐप्लिकेशन के नाम को @टैग करके, उसे शुरू करें.
  • Chat ऐप्लिकेशन के साथ डायरेक्ट मैसेज ढूंढें और शुरू करें. ऐप्लिकेशन मेन्यू में, डायरेक्ट मैसेज में Chat ऐप्लिकेशन का नाम और अवतार दिखता है.
  • कंपोज़ बार से, उपयोगकर्ता Chat ऐप्लिकेशन ब्राउज़ कर सकते हैं. साथ ही, उनका नाम, अवतार, और ब्यौरा देख सकते हैं.

Google Cloud कंसोल में अपना Chat ऐप्लिकेशन कॉन्फ़िगर करना

Chat ऐप्लिकेशन की जानकारी मिलने के बाद, अपना Cloud प्रोजेक्ट खोलें और Chat API को कॉन्फ़िगर करें:

  1. Google Cloud कंसोल में, Chat API पेज पर जाएं और कॉन्फ़िगरेशन पेज पर क्लिक करें:

    Chat API के कॉन्फ़िगरेशन पेज पर जाएं

  2. ऐप्लिकेशन की जानकारी में, ऐप्लिकेशन का नाम, अवतार यूआरएल, और ब्यौरा फ़ील्ड भरें.

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

  4. ज़रूरी नहीं: लॉग में जाकर, Google Cloud Logging का इस्तेमाल करने के लिए, लॉगिंग में गड़बड़ियों को लॉग करें चेकबॉक्स चुनें. ज़्यादा जानकारी के लिए, Chat ऐप्लिकेशन के लिए गड़बड़ी के लॉग की क्वेरी करना लेख पढ़ें.

  5. सेव करें पर क्लिक करें.

Chat API को कॉन्फ़िगर करने की अनुमति अन्य लोगों को देना

कुछ खास उपयोगकर्ताओं को, Chat ऐप्लिकेशन के कॉन्फ़िगरेशन पेज का ऐक्सेस दिया जा सकता है. इसके लिए, उन्हें Chat ऐप्लिकेशन के मालिक या Chat ऐप्लिकेशन के दर्शक की Google Cloud Identity Access Management (IAM) भूमिका दें. इन भूमिकाओं वाले उपयोगकर्ता, एपीआई और सेवाएं डैशबोर्ड का इस्तेमाल करके, Chat ऐप्लिकेशन के कॉन्फ़िगरेशन पेज पर नहीं जा सकते. हालांकि, वे Chat ऐप्लिकेशन के होस्ट क्लाउड प्रोजेक्ट के लिए, Google Cloud कंसोल पर जाकर, कॉन्फ़िगरेशन पेज को ऐक्सेस कर सकते हैं. इसके लिए, उन्हें यह तरीका अपनाना होगा:

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID

यहां PROJECT_ID, Chat ऐप्लिकेशन को होस्ट करने वाले Google Cloud प्रोजेक्ट की प्रोजेक्ट आईडी है.