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

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

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

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

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

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

उपयोगकर्ता प्रोफ़ाइल की जानकारी और दिखने के नियम

उपयोगकर्ता की पुष्टि का इस्तेमाल करके, Messages और Memberships API को कॉल करने पर, Google Chat API, User संसाधन में प्रोफ़ाइल की जानकारी भरता है. एपीआई, displayName, email, और avatarUrl को इंटरनल उपयोगकर्ताओं (आपके Google Workspace संगठन में) और बाहरी उपयोगकर्ताओं (बाहरी संगठनों या निजी Google खातों में) के लिए भरता है.

एपीआई से उपयोगकर्ता की प्रोफ़ाइलें भरने के उदाहरणों में ये जगहें शामिल हैं:

  • Message का sender.
  • मैसेज annotations में मौजूद उपयोगकर्ता, जैसे कि उपयोगकर्ता @mentions.
  • Membership संसाधन में मौजूद member.

निजता और दिखने से जुड़े नियम

उपयोगकर्ता की निजता की सुरक्षा के लिए, Google Chat API, उपयोगकर्ता की प्रोफ़ाइल की जानकारी भरने के दौरान, दिखने से जुड़े कुछ खास नियम लागू करता है:

  • भरी हुई प्रोफ़ाइल: अगर उपयोगकर्ता ने स्पेस का न्योता स्वीकार किया है (स्पेस का सदस्य है) या उसका कॉल करने वाले उपयोगकर्ता के साथ पहले से कोई संबंध है (जैसे, डायरेक्ट मैसेज के ज़रिए हुई बातचीत का इतिहास), तो एपीआई प्रोफ़ाइल की जानकारी भरता है. इसमें displayName, email, और avatarUrl मौजूद होते हैं. साथ ही, isAnonymous false होता है.
  • पहचान छिपाने वाली प्रोफ़ाइल: अगर किसी उपयोगकर्ता को स्पेस में सदस्य के तौर पर शामिल नहीं किया गया है और उसे कॉल करने वाले व्यक्ति के साथ पहले से कोई अफ़िनिटी नहीं है, तो उसकी प्रोफ़ाइल की पहचान छिपी रहती है. उपयोगकर्ता की पहचान ज़ाहिर न होने पर, isAnonymous true होता है. साथ ही, displayName, email, और avatarUrl जैसी जानकारी शामिल नहीं की जाती है. हालांकि, ऐप्लिकेशन की पुष्टि करके किए गए एपीआई अनुरोधों के लिए, displayName फ़ील्ड हमेशा भर जाता है.

यहां दिए गए JSON के उदाहरण में, User संसाधन दिखाया गया है. इसमें भरी गई प्रोफ़ाइल की जानकारी है. यह जानकारी, एपीआई से मिले जवाब या इंटरैक्शन इवेंट में दिखाई गई है:

{
  "name": "users/12345678901234567890",
  "displayName": "Sasha",
  "domainId": "123abc",
  "avatarUrl": "https://lh3.googleusercontent.com/.../photo.jpg",
  "email": "sasha@example.com",
  "type": "HUMAN",
  "isAnonymous": false
}

यहां दिए गए JSON उदाहरण में, पहचान छिपाने वाले User संसाधन को दिखाया गया है. इसमें कॉलर को उपयोगकर्ता की प्रोफ़ाइल की जानकारी नहीं दिखती:

{
  "name": "users/10987654321098765432",
  "type": "HUMAN",
  "isAnonymous": true
}

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 के तौर पर एक ही व्यक्ति को दिखाता है.
    • उपयोगकर्ता की पुष्टि करके किए गए एपीआई अनुरोधों के लिए, उपयोगकर्ता का ईमेल पता उपनाम के तौर पर—उदाहरण के लिए, users/EMAIL_USERNAME@WORKSPACE_DOMAIN.com.

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

    • ईमेल का कोई अन्य नाम—उदाहरण के लिए, users/EMAIL_USERNAME@WORKSPACE_DOMAIN.com या users/EMAIL_USERNAME@gmail.com.
    • User संसाधन का कैननिकल name (जैसे कि users/12345678901234567890). यह पिछले एपीआई कॉल या इंटरैक्शन इवेंट से मिला है.

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

एपीआई कॉल या इनकमिंग इवेंट से वापस लौटे उपयोगकर्ताओं की पहचान कई तरीकों से की जा सकती है:

  • Messages API: Message.sender से मैसेज भेजने वाले व्यक्ति की पहचान या Message.annotations[].userMention.user से टैग किए गए उपयोगकर्ताओं की पहचान पाएं.
  • Memberships API: Membership.member से सदस्य की पहचान पाएं.
  • इंटरैक्शन इवेंट: जब कोई उपयोगकर्ता Chat ऐप्लिकेशन से इंटरैक्ट करता है, तो Chat, Event.user में उपयोगकर्ता की पहचान के साथ इंटरैक्शन इवेंट भेजता है.

उपयोगकर्ता की पुष्टि करने की सुविधा का इस्तेमाल करने पर, Google Chat API, इंटरनल और बाहरी, दोनों तरह के उपयोगकर्ताओं के लिए प्रोफ़ाइलें भरता है. इसलिए, डेवलपर को सदस्यों और मैसेज भेजने वालों के नाम या ईमेल पते का पता लगाने के लिए, Directory API को कॉल करने की ज़रूरत नहीं होती.