หน้านี้จะอธิบายความแตกต่างระหว่างข้อความ SMS และข้อความในการ์ด
เมื่อแอปใน Chat ส่ง SMS เพื่อสื่อถึงข้อมูลพื้นฐาน ข้อความจะปรากฏขึ้นในบรรทัด เช่นเดียวกับการเขียนของผู้คนใน Google Chat ข้อความ ในการสร้างข้อความที่มีมากกว่า ข้อความ หรือเพื่อสร้าง ข้อความที่ผู้ใช้โต้ตอบด้วยได้, แอปใน Chat ใช้ได้ การ์ด แอปแชทยังเพิ่มข้อความต่อท้ายด้วยการ์ดได้อีกด้วย ถึง แจ้งให้ผู้ใช้ดำเนินการกระบวนการหลายขั้นตอนให้เสร็จสิ้น เช่น การกรอกแบบฟอร์ม แอปแชทยังสามารถสร้างการ์ดที่เปิดในหน้าต่างใหม่เป็น กล่องโต้ตอบ
โครงสร้างของข้อความ
ใน Google Chat API ระบบจะแสดงข้อความเป็นออบเจ็กต์ JSON ภายในข้อความ
ข้อความที่แสดงเป็น
text
ออบเจ็กต์
ในรายการต่อไปนี้ ตัวอย่างเช่น แอปใน Chat สร้าง SMS ในพื้นที่ทำงาน สำหรับทีมนักพัฒนาซอฟต์แวร์ที่ใกล้หยุดทำงานแล้ว
{
"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
และประกอบด้วยข้อมูลต่อไปนี้
- อย่างน้อย 1 รายการ
CardWithId
ออบเจ็กต์ cardId
ซึ่งใช้เพื่อระบุการ์ดและกำหนดขอบเขตภายในข้อความหนึ่งๆ (การ์ดในข้อความที่แตกต่างกันอาจมีรหัสเดียวกัน)ออบเจ็กต์
card
ซึ่งประกอบด้วยข้อมูลต่อไปนี้- ออบเจ็กต์
header
ซึ่งระบุสิ่งต่างๆ เช่น ชื่อ ชื่อรอง และรูปภาพรูปแบบรูปโปรไฟล์ - อย่างน้อย 1 รายการ
ออบเจ็กต์
section
รายการ แต่ละองค์ประกอบจะมีวิดเจ็ตอย่างน้อย 1 ชิ้น - อย่างน้อย 1 รายการ
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"
}
]
}
}
}
]
}
}
]
}
]
}
}
]
}
ใช้เครื่องมือสร้างการ์ดเพื่อออกแบบและแสดงตัวอย่างข้อความการ์ด JSON สำหรับแอป Chat ดังนี้
เปิดเครื่องมือสร้างการ์ด