Google Chat का इस्तेमाल करने वाले लोगों की पहचान करना और उनके बारे में बताना

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

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

Chat, उपयोगकर्ताओं की पहचान कैसे करता है

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

  • name, संसाधन का नाम है. इसे users/{user} के तौर पर फ़ॉर्मैट किया जाता है. इसमें {user}, यूनीक और स्टेबल आइडेंटिफ़ायर को दिखाता है. users/app का इस्तेमाल, कॉल करने वाले Chat ऐप्लिकेशन के लिए किसी दूसरे नाम के तौर पर किया जा सकता है.
  • type, उपयोगकर्ता का टाइप है. इस टाइप से Chat को पता चलता है कि उपयोगकर्ता, Chat ऐप्लिकेशन है या कोई व्यक्ति. चैट ऐप्लिकेशन के लिए, वैल्यू BOT होती है. लोगों के लिए, वैल्यू HUMAN होती है.

Google Chat API को कॉल करते समय किसी उपयोगकर्ता की जानकारी देना

किसी उपयोगकर्ता की जानकारी देने के लिए, {user} वैल्यू के लिए इन वैल्यू का इस्तेमाल करें:

  • Google Workspace के संगठन में शामिल उपयोगकर्ताओं के लिए, इनमें से किसी एक तरीके का इस्तेमाल करें:

    • Chat API में, User संसाधन का name, जैसे कि users/123456789.
    • People API में Person संसाधन के नाम के लिए {person_id}, जहां resourceName people/{person_id} है. उदाहरण के लिए, Chat API में users/123456789 उसी व्यक्ति को दिखाता है जिसे People API में people/123456789 दिखाया जाता है.
    • Directory API में User संसाधन के लिए id—उदाहरण के लिए, Chat API में users/123456789, Directory API में users/123456789 के तौर पर उसी व्यक्ति को दिखाता है.

  • Google Workspace के किसी बाहरी संगठन के उपयोगकर्ता या Google खाते का इस्तेमाल करने वाले उपयोगकर्ता के लिए, ईमेल पते के किसी दूसरे नाम का इस्तेमाल करें. उदाहरण के लिए, users/EMAIL_USERNAME@WORKSPACE_DOMAIN.com या users/EMAIL_USERNAME@gmail.com.

इंटरैक्शन इवेंट से उपयोगकर्ता की पहचान करना

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

Chat ऐप्लिकेशन से इंटरैक्ट करने वाले उपयोगकर्ता की पहचान करने के लिए, User रिसॉर्स पर name प्रॉपर्टी की वैल्यू पाएं. इसे Event.user.name से पाया जा सकता है.

यहां दिए गए JSON उदाहरण में, चैट ऐप्लिकेशन के साथ इंटरैक्शन में उपयोगकर्ता की पहचान का अनुमानित फ़ॉर्मैट दिखाया गया है:

{
  ...,
  "user": {
    "name": "users/12345678901234567890",
    "displayName": "Sasha",
    "avatarUrl": "https://lh3.googleusercontent.com/.../photo.jpg",
    "email": "sasha@example.com"
  }
}

मैसेज एक खास तरह का इंटरैक्शन है. Chat ऐप्लिकेशन पर मैसेज भेजने वाले उपयोगकर्ता की पहचान करने के लिए, User रिसॉर्स पर name प्रॉपर्टी की वैल्यू पाएं. इसके लिए, इनमें से किसी एक का इस्तेमाल करें: