تشرح هذه الصفحة الاختلافات بين رسائل الرسائل النصية ورسائل البطاقات.
عندما ترسِل تطبيقات Chat رسائل نصية لنقل المعلومات الأساسية، تظهر الرسائل مضمّنة، تمامًا مثلما يكتب المستخدمون في Google Chat الرسائل. لإنشاء رسائل تحتوي على أكثر من نص، أو لإنشاء رسائل يمكن للمستخدمين التفاعل معها، يمكن لتطبيقات 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"
}
]
}
}
}
]
}
}
]
}
]
}
}
]
}
يمكنك تصميم البطاقات ومعاينتها باستخدام أداة إنشاء البطاقات.
فتح أداة إنشاء البطاقات