इस पेज पर उन तरीकों के बारे में बताया गया है जिनसे Google Chat के ऐप्लिकेशन, 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
है.
- Chat एपीआई में मौजूद
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
प्रॉपर्टी की वैल्यू पाएं. इसके लिए, इनमें से किसी एक का इस्तेमाल करें:
मिलते-जुलते विषय
- स्पेस में किसी उपयोगकर्ता को जोड़ना.
- स्पेस में सदस्यों को मैनेज करना.
- @ ने मैसेज में किसी उपयोगकर्ता को टैग किया हो.