בדף הזה מוסבר איך אפליקציות של Google Chat יכולות לזהות או לציין משתמשי צ'אט.
כדי לבצע את הפעולות הבאות, צריך להשתמש באפליקציית Chat חייב לציין משתמש:
- ההודעה הזו צריכה @ מזכיר/ה משתמש.
- הזמנה או הוספה של משתמש המרחב הקיים, או להוסיף משתמש מרחב חדש.
- איך מחפשים צ'אטים אישיים בין אפליקציית Chat לבין משתמש מסוים, או בין שני משתמשים.
- איך מקבלים את פרטי המינוי של המשתמש במרחבים משותפים
- שליחת הודעה פרטית למשתמש.
- הרשמה למשתמש באמצעות Google Workspace Event API כדי לקבל אירועים שקשורים לשינויים במינוי.
איך אנחנו מזהים משתמשים ב-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:
מקבלים את הערך של המאפיין name
מקור מידע אחד (User
),
שאפשר לקבל מ-
Event.user.name
.
הדוגמה הבאה ב-JSON מציגה את הפורמט הצפוי של זהות המשתמש אינטראקציה עם אפליקציית Chat:
{
...,
"user": {
"name": "users/12345678901234567890",
"displayName": "Sasha",
"avatarUrl": "https://lh3.googleusercontent.com/.../photo.jpg",
"email": "[email protected]"
}
}
הודעה היא סוג ספציפי של אינטראקציה. כדי לזהות משתמש ששלח
הודעה לאפליקציית Chat,
מקבלים את הערך של המאפיין name
משאב User
, באמצעות אחד
הבאים:
נושאים קשורים
- איך מוסיפים משתמשים למרחבים משותפים
- איך מנהלים את רשימת המשתתפים במרחבים משותפים
- איך מזכירים משתמשים בהודעה באמצעות@