זיהוי וציון של משתמשי 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.

כדי לזהות את המשתמש שהייתה לו אינטראקציה עם אפליקציה של 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 באמצעות אחת מהאפשרויות הבאות: