ระบุตัวผู้ใช้ Google Chat

หน้านี้อธิบายวิธีที่แอป Google Chat สามารถระบุหรือระบุผู้ใช้ Chat

หากต้องการดำเนินการต่อไปนี้ แอป Chat ต้องระบุผู้ใช้

วิธีที่ Chat ระบุผู้ใช้

Google Chat API จะสร้างUserทรัพยากรสำหรับผู้ใช้แต่ละคนที่ใช้ Chat ฟิลด์Userที่สำคัญ 2 ฟิลด์มีดังนี้

  • name คือชื่อทรัพยากรของทรัพยากร โดยอยู่ในรูปแบบ users/{user} โดยที่ {user} เป็นตัวระบุที่ไม่ซ้ำและเสถียร users/app สามารถใช้เป็นอีเมลแทนสําหรับแอป Chat ที่ใช้โทรได้
  • type คือประเภทผู้ใช้ ประเภทนี้จะบอกให้ Chat ทราบว่าผู้ใช้เป็นแอป Chat หรือบุคคล สำหรับแอปรับแชท ค่าจะเป็น BOT สำหรับบุคคล ค่าจะเป็น HUMAN

ระบุผู้ใช้ในการเรียกใช้ Google Chat API

หากต้องการระบุผู้ใช้ ให้ใช้ค่าต่อไปนี้สำหรับค่า {user}

  • สำหรับผู้ใช้ในองค์กร Google Workspace ให้ใช้แนวทางใดแนวทางหนึ่งต่อไปนี้

    • name ของทรัพยากร User ใน Chat API เช่น users/123456789
    • {person_id} สำหรับชื่อแหล่งข้อมูล Person ใน People API โดยที่ resourceName คือ people/{person_id} เช่น users/123456789 ใน Chat API แสดงถึงบุคคลเดียวกันกับ people/123456789 ใน People API
    • id สำหรับทรัพยากร User ใน Directory API เช่น users/123456789 ใน Chat API แสดงถึงบุคคลเดียวกันกับ users/123456789 ใน Directory API

  • สำหรับผู้ใช้ในองค์กร Google Workspace ภายนอกหรือผู้ใช้ที่ใช้บัญชี Google ให้ใช้อีเมลแทน เช่น users/EMAIL_USERNAME@WORKSPACE_DOMAIN.com หรือ users/EMAIL_USERNAME@gmail.com

ระบุผู้ใช้จากเหตุการณ์การโต้ตอบ

ทุกครั้งที่ผู้ใช้โต้ตอบกับแอป Chat Chat จะส่งเหตุการณ์การโต้ตอบพร้อมข้อมูลเกี่ยวกับการโต้ตอบและผู้ใช้ เช่น เมื่อผู้ใช้พูดถึงแอป Chat ในข้อความ แอป Chat จะได้รับข้อมูลเกี่ยวกับการโต้ตอบ ซึ่งรวมถึงสิ่งที่ข้อความพูดและผู้ส่ง แอป Chat จะอ้างอิงผู้ใช้เมื่อดึงข้อมูลเกี่ยวกับทรัพยากรของ Chat

หากต้องการระบุผู้ใช้ที่โต้ตอบกับแอป Chat ให้รับค่าของพร็อพเพอร์ตี้ name ในแหล่งข้อมูล User ซึ่งคุณรับได้จาก Event.user.name

ตัวอย่าง JSON ต่อไปนี้แสดงรูปแบบที่คาดไว้ของข้อมูลประจำตัวของผู้ใช้ในการโต้ตอบกับแอป Chat

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

ข้อความเป็นการโต้ตอบประเภทหนึ่ง หากต้องการระบุผู้ใช้ที่ส่งข้อความไปยังแอป Chat ให้รับค่าของพร็อพเพอร์ตี้ name ในทรัพยากร User โดยใช้วิธีใดวิธีหนึ่งต่อไปนี้