זיהוי וציון של משתמשי Google Chat

בדף הזה מוסבר איך אפליקציות של Google 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: מקבלים את הערך של המאפיין 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, באמצעות אחד הבאים: