Event

אירוע אינטראקציה באפליקציה ב-Google Chat שמייצג ומכיל נתונים על האינטראקציה של משתמש עם אפליקציית Chat. כדי להגדיר שאפליקציית Chat תקבל אירועי אינטראקציה, קראו את המאמר קבלת אינטראקציות של משתמשים ומענה להן.

בנוסף לקבלת אירועים מאינטראקציות של משתמשים, אפליקציות Chat יכולות לקבל אירועים שקשורים לשינויים במרחבים משותפים, למשל כשמצרפים למרחבים משותפים חברים חדשים. מידע נוסף על אירועים במרחבים משותפים זמין במאמר עבודה עם אירועים מ-Google Chat.

ייצוג JSON 
{
  "type": enum (EventType),
  "eventTime": string,
  "token": string,
  "threadKey": string,
  "message": {
    object (Message)
  },
  "user": {
    object (User)
  },
  "space": {
    object (Space)
  },
  "action": {
    object (FormAction)
  },
  "configCompleteRedirectUrl": string,
  "isDialogEvent": boolean,
  "dialogEventType": enum (DialogEventType),
  "common": {
    object (CommonEventObject)
  }
}
שדות
type

enum (EventType)

סוג האינטראקציה של המשתמש עם אפליקציית Chat, למשל MESSAGE או ADDED_TO_SPACE.
eventTime

string (Timestamp format)

חותמת הזמן שמציינת מתי התרחש אירוע האינטראקציה.
token

string

ערך סודי שאפליקציות Chat מדור קודם יכולות להשתמש בו כדי לאמת אם בקשה מגיעה מ-Google. Google יוצרת את האסימון באופן אקראי והערך שלו נשאר סטטי. אפשר לקבל, לבטל או ליצור מחדש את האסימון דרך דף ההגדרות של Chat API במסוף Google Cloud.

אפליקציות Chat מודרניות לא משתמשות בשדה הזה. הוא לא מופיע בתגובות מה-API ובדף התצורה של Chat API.
threadKey

string

המפתח שהוגדר על ידי אפליקציית Chat לשרשור שקשור לאירוע האינטראקציה. מידע נוסף זמין בכתובת spaces.messages.thread.threadKey.
message

object (Message)

באירועי אינטראקציה מסוג ADDED_TO_SPACE,‏ CARD_CLICKED ו-MESSAGE, ההודעה שהפעילה את אירוע האינטראקציה, אם רלוונטי.
user

object (User)

המשתמש שביצע אינטראקציה עם אפליקציית Chat.
space

object (Space)

המרחב שבו המשתמש קיים אינטראקציה עם אפליקציית Chat.
action

object (FormAction)

באירועי אינטראקציה מסוג CARD_CLICKED, נתוני הפעולות בטופס שמשויכים כשמשתמש לוחץ על כרטיס או על תיבת דו-שיח. מידע נוסף זמין במאמר בנושא קריאת נתוני טפסים שהמשתמשים מזינים בכרטיסים.
configCompleteRedirectUrl

string

באירועי אינטראקציה מסוג MESSAGE, כתובת ה-URL שאליה המשתמשים צריכים לקבל הפניה אוטומטית אחרי שהם משלימים תהליך הרשאה או הגדרה מחוץ ל-Google Chat. מידע נוסף זמין במאמר חיבור אפליקציית Chat לשירותים ולכלים אחרים.
isDialogEvent

boolean

באירועי אינטראקציה של CARD_CLICKED ו-MESSAGE, האם המשתמש מקיים אינטראקציה עם תיבת דו-שיח או עומד ליצור איתו אינטראקציה.
dialogEventType

enum (DialogEventType)

סוג אירוע האינטראקציה של תיבת הדו-שיח שהתקבל.
common

object (CommonEventObject)

מייצג מידע על הלקוח של המשתמש, כמו אזור זמן, אפליקציית מארח ופלטפורמה. באפליקציות ל-Chat, CommonEventObject כולל מידע שנשלח על ידי משתמשים שהייתה להם אינטראקציה עם תיבות דו-שיח, כמו נתונים שהוזנו בכרטיס.

CommonEventObject

מייצג מידע על הלקוח של המשתמש, כמו הלוקאל, האפליקציה המארחת והפלטפורמה. באפליקציות Chat, השדה CommonEventObject כולל נתונים שנשלחו על ידי משתמשים שמקיימים אינטראקציה עם כרטיסים, כמו נתונים שהוזנו בתיבות דו-שיח.

ייצוג JSON 
{
  "userLocale": string,
  "hostApp": enum (HostApp),
  "platform": enum (Platform),
  "timeZone": {
    object (TimeZone)
  },
  "formInputs": {
    string: {
      object (Inputs)
    },
    ...
  },
  "parameters": {
    string: string,
    ...
  },
  "invokedFunction": string
}
שדות
userLocale

string

הערך המלא של locale.displayName בפורמט [קוד שפה לפי תקן ISO 639]-[קוד מדינה/אזור לפי תקן ISO 3166], למשל 'en-US'.
hostApp

enum (HostApp)

המאפיין המסווג (enum) hostApp שמציין את האפליקציה שממנה התוסף הופעל. תמיד CHAT באפליקציות ל-Chat.
platform

enum (Platform)

הפלטפורמה 'טיפוסים בני מנייה (enum)' שמציינת את הפלטפורמה שממנה הגיע האירוע (WEB, IOS או ANDROID). האפשרות הזו לא נתמכת באפליקציות ל-Chat.
timeZone

object (TimeZone)

מזהה אזור הזמן והיסט לעומת 'זמן אוניברסלי מתואם' (UTC). האפשרות נתמכת רק בסוגי האירועים CARD_CLICKED ו-SUBMIT_DIALOG.
formInputs

map (key: string, value: object (Inputs))

מפה שמכילה את הערכים שהמשתמש מזין בווידג'ט מכרטיס או מתיבת דו-שיח. מקשי המפה הם מזהי המחרוזת שמוקצים לכל ווידג'ט, והערכים מייצגים את ערכי הקלט לווידג'ט.

פרטים נוספים זמינים במאמר עיבוד מידע שהמשתמשים מזינים.
parameters

map (key: string, value: string)

פרמטרים מותאמים אישית שהועברו לפונקציה שהופעל. המפתחות והערכים חייבים להיות מחרוזות.
invokedFunction

string

השם של הפונקציה שמופעלת שמשויכת לווידג'ט. מוגדר רק לאפליקציות Chat.

TimeZone

מזהה אזור הזמן והסטייה מזמן אוניברסלי מתואם (UTC). האפשרות נתמכת רק בסוגי האירועים CARD_CLICKED ו-SUBMIT_DIALOG.

ייצוג JSON 
{
  "id": string,
  "offset": integer
}
שדות
id

string

קוד מסד הנתונים של אזור הזמן IANA TZ, למשל 'America/Toronto'.
offset

integer

הסטייה מאזור הזמן של המשתמש, באלפיות שנייה, מזמן אוניברסלי מתואם (UTC).

קלט

סוגי הנתונים שהמשתמשים יכולים להזין בכרטיסים או בתיבות דו-שיח. סוג הקלט תלוי בסוג הערכים שהווידג'ט מקבל.

ייצוג ב-JSON 
{

  // Union field inputs can be only one of the following:
  "stringInputs": {
    object (StringInputs)
  },
  "dateTimeInput": {
    object (DateTimeInput)
  },
  "dateInput": {
    object (DateInput)
  },
  "timeInput": {
    object (TimeInput)
  }
  // End of list of possible types for union field inputs.
}
שדות

שדה איחוד inputs.

inputs יכול להיות רק אחת מהאפשרויות הבאות:
stringInputs

object (StringInputs)

רשימת מחרוזות שמייצגות את הערכים שהמשתמש הזין בווידג'ט.

אם הווידג'ט מקבל רק ערך אחד, כמו ווידג'ט TextInput, הרשימה מכילה אובייקט מחרוזת אחד. אם בווידג'ט אפשר להשתמש בכמה ערכים, למשל ווידג'ט SelectionInput לתיבות סימון, הרשימה תכיל אובייקט מסוג מחרוזת לכל ערך שהמשתמש מזין או בוחר.
dateTimeInput

object (DateTimeInput)

ערכי קלט של תאריך ושעה מווידג'ט DateTimePicker שמקבל גם תאריך וגם שעה.
dateInput

object (DateInput)

ערכים להזנת תאריך מהווידג'ט DateTimePicker שמקבל רק ערכי תאריכים.
timeInput

object (TimeInput)

ערכים של קלט הזמן מהווידג'ט DateTimePicker שמקבל רק ערכי זמן.

StringInputs

פרמטר של קלט לווידג'טים רגילים. בווידג'טים עם ערך יחיד, מדובר ברשימה של ערכים בודדים. בווידג'טים עם ערכים מרובים, כמו תיבת סימון, מוצגים כל הערכים.

ייצוג ב-JSON 
{
  "value": [
    string
  ]
}
שדות
value[]

string

רשימה של מחרוזות שהמשתמש הזין.

DateTimeInput

ערכי קלט של תאריך ושעה.

ייצוג JSON 
{
  "msSinceEpoch": string,
  "hasDate": boolean,
  "hasTime": boolean
}
שדות
msSinceEpoch

string (int64 format)

הזמן מאז תחילת התקופה של זמן מערכת, באלפיות השנייה.
hasDate

boolean

האם הקלט של datetime כולל תאריך ביומן.
hasTime

boolean

האם הקלט datetime כולל חותמת זמן.

DateInput

ערכי קלט של תאריכים.

ייצוג JSON 
{
  "msSinceEpoch": string
}
שדות
msSinceEpoch

string (int64 format)

הזמן שחלף מאז תחילת התקופה, באלפיות שנייה.

TimeInput

ערכי קלט של זמן.

ייצוג ב-JSON 
{
  "hours": integer,
  "minutes": integer
}
שדות
hours

integer

השעה בשעון של 24 שעות.
minutes

integer

מספר הדקות לאחר השעה. הערכים החוקיים הם 0 עד 59.