בדף הזה מוסבר איך אפליקציות Google Chat יכולות לזהות או לציין משתמשי צ'אט.
כדי לבצע אחת מהפעולות הבאות, צריך לציין משתמש באפליקציית Chat:
- כדי לשלוח הודעה כשיש אזכור של משתמש ב-@
- להזמין או להוסיף משתמש למרחב משותף קיים, או להוסיף אותו למרחב משותף חדש.
- חיפוש צ'אטים בין אפליקציית Chat למשתמש ספציפי או בין שני משתמשים.
- איך מקבלים את פרטי המינוי של המשתמש במרחבים משותפים.
- שליחת הודעה פרטית למשתמש.
איך אנחנו מזהים משתמשים ב-Chat
Google Chat API יוצר משאב User
לכל משתמש שמשתמש ב-Chat. בהמשך מופיעים שני שדות 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.
כדי לזהות את המשתמש שהייתה לו אינטראקציה עם אפליקציה של 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
באמצעות אחת מהאפשרויות הבאות:
נושאים קשורים
- הוספת משתמש למרחבים משותפים.
- איך מנהלים את רשימת המשתתפים במרחבים משותפים
- אזכור משתמש בהודעה באמצעות@.