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

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

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

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

Google Chat API จะสร้าง แหล่งข้อมูล User รายการ สำหรับผู้ใช้แต่ละคนที่ใช้ Chat ซึ่งมีข้อมูลสำคัญ 2 ประการดังนี้ User ช่อง:

  • 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 ดึงค่าของพร็อพเพอร์ตี้ 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 โดยใช้ ดังต่อไปนี้: