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

इस पेज पर उन तरीकों के बारे में बताया गया है जिनसे Google Chat के ऐप्लिकेशन, 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 एपीआई में मौजूद User संसाधन का name, जैसे कि users/123456789.
    • People API में Person संसाधन के नाम के लिए {person_id}, जहां resourceName people/{person_id} है. उदाहरण के लिए, Chat API में users/123456789 उसी व्यक्ति को दिखाता है जो लोगों एपीआई में people/123456789 है.
    • डायरेक्ट्री एपीआई में मौजूद User संसाधन के लिए id, उदाहरण के लिए, Chat API में users/123456789 उसी व्यक्ति को दिखाता है जो डायरेक्ट्री एपीआई में users/123456789 है.

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

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

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

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

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

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

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