בדף הזה מוסברים ההבדלים בין הודעות טקסט לבין הודעות בכרטיס.
כשאפליקציות Chat שולחות הודעות טקסט כדי להעביר מידע בסיסי, ההודעות מופיעות בתוך השורה, בדיוק כמו האופן שבו אנשים ב-Google Chat כותבים הודעות. כדי ליצור הודעות שמכילות יותר מטקסט או כדי ליצור הודעות שמשתמשים יכולים לתקשר איתן, אפליקציות Chat יכולות להשתמש בכרטיסים. אפליקציות צ'אט יכולות גם לצרף הודעת טקסט עם כרטיס. כדי להנחות את המשתמשים להשלים תהליכים מרובי שלבים, כמו מילוי טופס, אפליקציות Chat יכולות גם ליצור כרטיסים שנפתחים בחלון חדש בתור תיבות דו-שיח.
המבנה של הודעת טקסט
ב-Google Chat API, ההודעות מיוצגות כאובייקטים של JSON. בתוך הודעה, הודעת טקסט מיוצגת כאובייקט text
.
בדוגמה הבאה, אפליקציית Chat יוצרת הודעת טקסט במרחב משותף למפתחי תוכנה, שאליו מתקרבים הקפאת הקוד:
{
"text": "Attention <users/all>: Code freeze starts at `11:59 am` Pacific Standard Time! If you need a little more time, type `/moreTime` and I'll push the code freeze back one hour."
}
ה-JSON יחזיר את ההודעה הבאה:
המבנה של הודעת כרטיס
ב-Google Chat API, ההודעות מיוצגות כאובייקטים של JSON. בהודעה, כרטיס מיוצג כמערך cardsV2
ומורכב מהרכיבים הבאים:
- אובייקט
CardWithId
אחד או יותר. cardId
, שמשמש לזיהוי הכרטיס וההיקף של הודעה נתונה. (כרטיסים בהודעות שונות יכולים להיות עם אותו מזהה).אובייקט
card
, שכולל את הפריטים הבאים:- אובייקט
header
שמציין דברים כמו כותרת, כותרת משנה ותמונה בסגנון דמות. - אובייקט
section
אחד או יותר, שכל אחד מהם מכיל לפחות ווידג'ט אחד. - אובייקט
widget
אחד או יותר. כל ווידג'ט הוא אובייקט מורכב שיכול לייצג טקסט, תמונות, לחצנים וסוגי אובייקטים אחרים.
- אובייקט
לדוגמה, הודעת הכרטיס הבאה מכילה את האובייקטים header
, section
ו-widget
:
הקוד הבא מייצג את קובץ ה-JSON של הודעת הכרטיס:
JSON
{
"cardsV2": [
{
"cardId": "unique-card-id",
"card": {
"header": {
"title": "Sasha",
"subtitle": "Software Engineer",
"imageUrl": "https://developers.google.com/chat/images/quickstart-app-avatar.png",
"imageType": "CIRCLE",
"imageAltText": "Avatar for Sasha"
},
"sections": [
{
"header": "Contact Info",
"collapsible": true,
"uncollapsibleWidgetsCount": 1,
"widgets": [
{
"decoratedText": {
"startIcon": {
"knownIcon": "EMAIL"
},
"text": "sasha@example.com"
}
},
{
"decoratedText": {
"startIcon": {
"knownIcon": "PERSON"
},
"text": "<font color=\"#80e27e\">Online</font>"
}
},
{
"decoratedText": {
"startIcon": {
"knownIcon": "PHONE"
},
"text": "+1 (555) 555-1234"
}
},
{
"buttonList": {
"buttons": [
{
"text": "Share",
"onClick": {
"openLink": {
"url": "https://example.com/share"
}
}
},
{
"text": "Edit",
"onClick": {
"action": {
"function": "goToView",
"parameters": [
{
"key": "viewType",
"value": "EDIT"
}
]
}
}
}
]
}
}
]
}
]
}
}
]
}
עצב כרטיסים והצג תצוגה מקדימה שלהם באמצעות הכלי ליצירת כרטיסים.
לפתיחת הכלי ליצירת כרטיסים