בדף הזה מוסבר איך ליצור דף בית להודעות אישיות באפליקציית Google Chat. דף הבית, שנקרא דף הבית של האפליקציה ב-Google Chat API, הוא ממשק כרטיסים שניתן להתאמה אישית, שמופיע בכרטיסייה דף הבית של מרחבים של הודעות אישיות בין משתמש לאפליקציית Chat.
אתם יכולים להשתמש בדף הבית של האפליקציה כדי לשתף טיפים לשימוש באפליקציית Chat, או כדי לאפשר למשתמשים לגשת לשירות או כלי חיצוניים ולהשתמש בהם מתוך Chat.
בעזרת הכלי ליצירת כרטיסים תוכלו לעצב ממשקי משתמש ותכונות שליחת הודעות לאפליקציות Chat ולראות תצוגה מקדימה שלהן:
פתיחת הכלי ליצירת כרטיסיםדרישות מוקדמות
Node.js
אפליקציית Google Chat שמופעלות בה תכונות אינטראקטיביות. כדי ליצור אפליקציה אינטראקטיבית ל-Chat באמצעות שירות HTTP, תוכלו להיעזר במדריך למתחילים הזה.
Python
אפליקציית Google Chat שמופעלות בה תכונות אינטראקטיביות. כדי ליצור אפליקציה אינטראקטיבית ל-Chat באמצעות שירות HTTP, תוכלו להיעזר במדריך למתחילים הזה.
Java
אפליקציית Google Chat שמופעלות בה תכונות אינטראקטיביות. כדי ליצור אפליקציה אינטראקטיבית ל-Chat באמצעות שירות HTTP, תוכלו להיעזר במדריך למתחילים הזה.
Apps Script
אפליקציית Google Chat שמופעלות בה תכונות אינטראקטיביות. כדי ליצור אפליקציית Chat אינטראקטיבית ב-Apps Script, אפשר להיעזר במדריך למתחילים.
הגדרת דף הבית של האפליקציה ב-Chat
כדי לתמוך בדף הבית של האפליקציה, צריך להגדיר באפליקציית Chat קבלה של אירועי אינטראקציה מסוג APP_HOME
. אפליקציית Chat מקבלת את האירוע הזה בכל פעם שמשתמש לוחץ על הכרטיסייה דף הבית בצ'אט אישי באפליקציית Chat.
כדי לעדכן את הגדרות התצורה במסוף Google Cloud:
במסוף Google Cloud, עוברים אל תפריט > מוצרים נוספים > Google Workspace > Product Library > Google Chat API.
לוחצים על ניהול ואז על הכרטיסייה הגדרה.
בקטע תכונות אינטראקטיביות, עוברים לקטע פונקציונליות כדי להגדיר את דף הבית של האפליקציה:
- מסמנים את התיבה קבלת הודעות 1:1.
- מסמנים את התיבה Support App Home.
אם אפליקציית Chat משתמשת בשירות HTTP, עוברים אל הגדרות החיבור ומציינים נקודת קצה בשדה כתובת ה-URL של דף הבית של האפליקציה. אפשר להשתמש באותה כתובת URL שציינתם בשדה כתובת URL של נקודת קצה מסוג HTTP.
לוחצים על שמירה.
יצירת כרטיס דף הבית של אפליקציה
כשמשתמש פותח את דף הבית של האפליקציה, אפליקציית Chat צריכה להתמודד עם אירוע האינטראקציה APP_HOME
על ידי החזרת מופע של
RenderActions
עם ניווט pushCard
ו-Card
. כדי ליצור חוויה אינטראקטיבית, הכרטיס יכול להכיל ווידג'טים אינטראקטיביים כמו לחצנים או קלט טקסט שאפליקציית Chat יכולה לעבד ולהשיב להם באמצעות כרטיסים נוספים, או תיבת דו-שיח.
בדוגמה הבאה, באפליקציית Chat מוצג כרטיס דף הבית הראשוני עם השעה שבה נוצר הכרטיס ולחצן. כשהמשתמש לוחץ על הלחצן, אפליקציית Chat מחזירה כרטיס מעודכן עם השעה שבה נוצר הכרטיס המעודכן.
Node.js
Python
Java
Apps Script
מטמיעים את הפונקציה onAppHome
שנקראת אחרי כל אירועי האינטראקציה APP_HOME
:
בדוגמה הזו, ההודעה על הכרטיס נשלחת על ידי החזרת card JSON. אפשר גם להשתמש בשירות הכרטיסים של Apps Script.
תגובה לאינטראקציות במסך הבית של האפליקציה
אם הכרטיס הראשוני של האפליקציה מכיל ווידג'טים אינטראקטיביים, כמו לחצנים או אפשרויות קלט לבחירה, אפליקציית Chat צריכה להחזיר מופע של RenderActions
עם ניווט updateCard
כדי לטפל באירועי האינטראקציה הקשורים. למידע נוסף על טיפול בווידג'טים אינטראקטיביים, עיינו במאמר עיבוד מידע שהוזן על ידי משתמשים.
בדוגמה הקודמת, הכרטיס הראשוני של דף הבית של האפליקציה כלל לחצן. בכל פעם שמשתמש לוחץ על הלחצן, אירוע אינטראקציה מסוג CARD_CLICKED
מפעיל את הפונקציה updateAppHome
כדי לרענן את כרטיס הבית של האפליקציה, כפי שמוצג בקוד הבא:
Node.js
Python
Java
Apps Script
בדוגמה הזו, ההודעה על הכרטיס נשלחת על ידי החזרת card JSON. אפשר גם להשתמש בשירות הכרטיסים של Apps Script.
פתיחת תיבות דו-שיח
אפליקציית Chat יכולה גם להגיב לאינטראקציות בדף הבית של האפליקציה על ידי פתיחת תיבות דו-שיח.
כדי לפתוח תיבת דו-שיח מדף הבית של האפליקציה, מעבדים את אירוע האינטראקציה הקשור על ידי החזרת renderActions
עם ניווט updateCard
שמכיל אובייקט Card
. בדוגמה הבאה, אפליקציית Chat מגיבה ללחיצה על לחצן בכרטיס הבית של האפליקציה על ידי עיבוד אירוע האינטראקציה CARD_CLICKED
ופתיחת תיבת דו-שיח:
{ renderActions: { action: { navigations: [{ updateCard: { sections: [{
header: "Add new contact",
widgets: [{ "textInput": {
label: "Name",
type: "SINGLE_LINE",
name: "contactName"
}}, { textInput: {
label: "Address",
type: "MULTIPLE_LINE",
name: "address"
}}, { decoratedText: {
text: "Add to favorites",
switchControl: {
controlType: "SWITCH",
name: "saveFavorite"
}
}}, { decoratedText: {
text: "Merge with existing contacts",
switchControl: {
controlType: "SWITCH",
name: "mergeContact",
selected: true
}
}}, { buttonList: { buttons: [{
text: "Next",
onClick: { action: { function: "openSequentialDialog" }}
}]}}]
}]}}]}}}
כדי לסגור תיבת דו-שיח, מעבדים את אירועי האינטראקציה הבאים:
CLOSE_DIALOG
: סגירת תיבת הדו-שיח וחזרה לכרטיס הבית הראשוני של אפליקציית Chat.CLOSE_DIALOG_AND_EXECUTE
: סוגר את תיבת הדו-שיח ומרענן את כרטיס הבית של האפליקציה.
בדוגמת הקוד הבאה נעשה שימוש ב-CLOSE_DIALOG
כדי לסגור תיבת דו-שיח ולחזור לכרטיס הבית של האפליקציה:
{ renderActions: { action: {
navigations: [{ endNavigation: { action: "CLOSE_DIALOG" }}]
}}}
כדי לאסוף מידע ממשתמשים, אפשר גם ליצור תיעודים של שיחות רצופות. כדי ללמוד איך ליצור תיבות דו-שיח עוקבות, ראו פתיחה של תיבות דו-שיח ומענה להן.
נושאים קשורים
- הצגת דוגמאות של אפליקציות ל-Chat בדף הבית של האפליקציות.
- פתיחה של תיבות דו-שיח ותשובה להן.