אירוע אינטראקציה באפליקציה ב-Google Chat שמייצג ומכיל נתונים על האינטראקציה של משתמש עם אפליקציית Chat. כדי להגדיר את אפליקציית Chat לקבלת אירועי אינטראקציה, קראו את המאמר קבלת אינטראקציות של משתמשים ומענה להן.
בנוסף לקבלת אירועים מאינטראקציות של משתמשים, אפליקציות Chat יכולות לקבל אירועים שקשורים לשינויים במרחבים משותפים, למשל כשמצרפים למרחבים משותפים חברים חדשים. מידע נוסף על אירועים במרחב המשותף מופיע במאמר איך עובדים עם אירועים מ-Google Chat.
ייצוג JSON |
---|
{ "type": enum ( |
שדות | |
---|---|
type |
סוג האינטראקציה של המשתמש עם אפליקציית Chat, למשל |
eventTime |
חותמת הזמן שמציינת מתי התרחש אירוע האינטראקציה. |
token |
ערך סודי שיכול לשמש אפליקציות Chat מדור קודם כדי לאמת אם הבקשה היא מ-Google. Google יוצרת את האסימון באופן אקראי והערך שלו נשאר סטטי. אתם יכולים לקבל, לבטל או ליצור מחדש את האסימון מדף ההגדרה של Chat API שבמסוף Google Cloud. באפליקציות מודרניות ל-Chat לא נעשה שימוש בשדה הזה. היא לא מופיעה בתשובות של ה-API ובדף ההגדרה של Chat API. |
threadKey |
המפתח שהוגדר על ידי אפליקציית Chat לשרשור שקשור לאירוע האינטראקציה. מידע נוסף זמין בכתובת |
message |
ההודעה שהפעילה את אירוע האינטראקציה, אם רלוונטי. |
user |
המשתמש שהייתה לו אינטראקציה עם אפליקציית Chat. |
space |
המרחב שבו המשתמש ניהל אינטראקציה עם אפליקציית Chat. |
action |
באירועי אינטראקציה מסוג |
configCompleteRedirectUrl |
באירועי אינטראקציה מסוג |
isDialogEvent |
באירועי אינטראקציה של |
dialogEventType |
סוג אירוע האינטראקציה תיבת דו-שיח שהתקבל. |
common |
מייצג מידע על הלקוח של המשתמש, כמו הלוקאל, האפליקציה המארחת והפלטפורמה. באפליקציות ל-Chat, |
CommonEventObject
מייצג מידע על הלקוח של המשתמש, כמו הלוקאל, האפליקציה המארחת והפלטפורמה. באפליקציות ל-Chat, הערך CommonEventObject
כולל נתונים שנשלחו על ידי משתמשים שהייתה להם אינטראקציה עם כרטיסים, כמו נתונים שהוזנו בתיבות דו-שיח.
ייצוג JSON |
---|
{ "userLocale": string, "hostApp": enum ( |
שדות | |
---|---|
userLocale |
|
hostApp |
ערך HostApp enum שמציין את האפליקציה שממנה התוסף מופעל. תמיד |
platform |
הפלטפורמה 'טיפוסים בני מנייה (enum)' שמציינת את הפלטפורמה שממנה הגיע האירוע ( |
timeZone |
מזהה אזור הזמן והיסט לעומת 'זמן אוניברסלי מתואם' (UTC). האפשרות נתמכת רק בסוגי האירועים |
formInputs |
מפה שמכילה את הערכים שמשתמש מזין בווידג'ט, בכרטיס או בתיבת דו-שיח. מקשי המפה הם מזהי המחרוזת שמוקצים לכל ווידג'ט, והערכים מייצגים את ערכי הקלט לווידג'ט. מידע נוסף זמין במאמר בנושא פרטי התהליך שהוזנו על ידי משתמשים. |
parameters |
פרמטרים מותאמים אישית שמועברים לפונקציה שמופעלת. המפתחות והערכים חייבים להיות מחרוזות. |
invokedFunction |
השם של הפונקציה שמופעלת שמשויכת לווידג'ט. מוגדר רק לאפליקציות צ'אט. |
TimeZone
מזהה אזור הזמן והיסט לעומת 'זמן אוניברסלי מתואם' (UTC). האפשרות נתמכת רק בסוגי האירועים CARD_CLICKED
ו-SUBMIT_DIALOG
.
ייצוג JSON |
---|
{ "id": string, "offset": integer } |
שדות | |
---|---|
id |
קוד מסד הנתונים של אזור הזמן IANA TZ, למשל 'America/Toronto'. |
offset |
הסטייה מאזור הזמן של המשתמש, באלפיות שנייה, מזמן אוניברסלי מתואם (UTC). |
קלט
סוגי הנתונים שהמשתמשים יכולים להזין בכרטיסים או בתיבות דו-שיח. סוג הקלט תלוי בסוג הערכים שהווידג'ט מקבל.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד
|
|
stringInputs |
רשימת מחרוזות שמייצגות את הערכים שהמשתמש הזין בווידג'ט. אם הווידג'ט מקבל רק ערך אחד, כמו ווידג'ט |
dateTimeInput |
הערכים של התאריך והשעה מהווידג'ט |
dateInput |
ערכים להזנת תאריך מהווידג'ט |
timeInput |
ערכים של קלט הזמן מהווידג'ט |
StringInputs
פרמטר של קלט לווידג'טים רגילים. בווידג'טים עם ערך יחיד, מדובר ברשימה של ערכים בודדים. בווידג'טים בעלי ערכים מרובים, כמו תיבות סימון, כל הערכים מוצגים.
ייצוג JSON |
---|
{ "value": [ string ] } |
שדות | |
---|---|
value[] |
רשימת מחרוזות שהמשתמש הזין. |
DateTimeInput
ערכי קלט של תאריך ושעה.
ייצוג JSON |
---|
{ "msSinceEpoch": string, "hasDate": boolean, "hasTime": boolean } |
שדות | |
---|---|
msSinceEpoch |
הזמן שחלף מאז תחילת התקופה, באלפיות שנייה. |
hasDate |
האם הקלט |
hasTime |
האם הקלט |
DateInput
ערכי קלט של תאריכים.
ייצוג JSON |
---|
{ "msSinceEpoch": string } |
שדות | |
---|---|
msSinceEpoch |
הזמן שחלף מאז תחילת התקופה, באלפיות שנייה. |
TimeInput
ערכים של קלט זמן.
ייצוג JSON |
---|
{ "hours": integer, "minutes": integer } |
שדות | |
---|---|
hours |
השעה בשעון של 24 שעות. |
minutes |
מספר הדקות לאחר השעה. הערכים החוקיים הם 0 עד 59. |