หน้านี้อธิบายวิธีที่แอป Google Chat จะระบุหรือระบุผู้ใช้ Chat
หากต้องการดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้ แอป Chat จะต้องระบุผู้ใช้
- สร้างข้อความที่ @ พูดถึงผู้ใช้
- เชิญหรือเพิ่มผู้ใช้ลงในพื้นที่ทำงานที่มีอยู่ หรือเพิ่มผู้ใช้ลงในพื้นที่ทำงานใหม่
- ค้นหาข้อความส่วนตัวระหว่างแอป Chat กับผู้ใช้ที่ระบุ หรือระหว่างผู้ใช้ 2 คน
- ดูรายละเอียดการเป็นสมาชิกของผู้ใช้ในพื้นที่ทำงาน
- ส่งข้อความส่วนตัวถึงผู้ใช้
วิธีที่ Chat ระบุผู้ใช้
Google Chat API จะสร้างทรัพยากร User
ให้กับผู้ใช้แต่ละคนที่ใช้ Chat ช่อง User
ที่สำคัญ 2 ช่องมีดังนี้
name
เป็นชื่อทรัพยากรสำหรับทรัพยากร ซึ่งอยู่ในรูปแบบusers/{user}
โดยที่{user}
แสดงถึงตัวระบุที่ไม่ซ้ำกันและเสถียร คุณใช้users/app
เป็นชื่อแทนสำหรับแอปที่เรียกใช้ Chat ได้type
เป็นประเภทของผู้ใช้ ประเภทนี้จะทำให้ Chat ทราบว่าผู้ใช้เป็นแอป 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 APIid
สำหรับทรัพยากร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
โดยใช้ค่าใดค่าหนึ่งต่อไปนี้