Card
การ์ดเป็นองค์ประกอบ UI ที่สามารถมีวิดเจ็ต UI ได้ เช่น ข้อความและรูปภาพ
การแสดง JSON |
---|
{ "header": { object ( |
ช่อง | |
---|---|
header
|
ส่วนหัวของการ์ด ปกติแล้วส่วนหัวจะมีชื่อและรูปภาพ |
sections[]
|
ส่วนถูกคั่นด้วยตัวแบ่งบรรทัด |
cardActions[]
|
การดําเนินการของการ์ดนี้ |
name
|
ชื่อการ์ด |
ส่วนหัวของการ์ด
การแสดง JSON |
---|
{
"title": string,
"subtitle": string,
"imageStyle": enum (
|
ช่อง | |
---|---|
title
|
ต้องระบุชื่อ ส่วนหัวมีความสูงคงที่คือหากระบุทั้งชื่อและคําบรรยาย แต่ละบรรทัดจะใช้ 1 บรรทัด หากมีการระบุแค่ชื่อวิดีโอ ชื่อจะแสดงภายในทั้ง 2 บรรทัด |
subtitle
|
คําบรรยายในส่วนหัวของการ์ด |
imageStyle
|
ชนิดของรูปภาพ (เช่น เส้นขอบสี่เหลี่ยมจัตุรัสหรือเส้นขอบวงกลม) |
imageUrl
|
URL ของรูปภาพในส่วนหัวของการ์ด |
รูปแบบภาพ
Enum | |
---|---|
IMAGE_STYLE_UNSPECIFIED
|
|
IMAGE
|
เส้นขอบสี่เหลี่ยมจัตุรัส |
AVATAR
|
เส้นขอบวงกลม |
ส่วน
ส่วนนี้ประกอบด้วยคอลเล็กชันของวิดเจ็ตที่แสดงผล (แนวตั้ง) ตามลําดับที่ระบุ ในทุกแพลตฟอร์ม การ์ดจะมีความกว้างคงที่ จึงไม่จําเป็นต้องใช้คุณสมบัติของการออกแบบ (เช่น float)
การแสดง JSON |
---|
{
"header": string,
"widgets": [
{
object (
|
ช่อง | |
---|---|
header
|
ส่วนหัวของหัวข้อ รองรับข้อความที่จัดรูปแบบ โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดรูปแบบข้อความในหัวข้อการจัดรูปแบบข้อความในแอป Google Chat และการจัดรูปแบบข้อความในส่วนเสริม Google Workspace |
widgets[]
|
ส่วนต้องมีวิดเจ็ตอย่างน้อย 1 รายการ |
Widget ของมาร์กอัป
วิดเจ็ตคือองค์ประกอบ UI ที่แสดงข้อความและรูปภาพ
การแสดง JSON |
---|
{ "buttons": [ { object ( |
ช่อง | |
---|---|
buttons[]
|
รายการปุ่ม นอกจากนี้ ปุ่มต่างๆ ยังรวมถึง |
ช่อง Union
data WidgetMarkup มีรายการใดรายการหนึ่งต่อไปนี้เท่านั้น คุณใช้ช่อง WidgetMarkup หลายช่องเพื่อแสดงรายการเพิ่มเติมได้
data
ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
|
|
textParagraph
|
แสดงย่อหน้าข้อความในวิดเจ็ตนี้ |
image
|
แสดงภาพในวิดเจ็ตนี้ |
keyValue
|
แสดงรายการคีย์-ค่าในวิดเจ็ตนี้ |
ย่อหน้าข้อความ
ย่อหน้าของข้อความ รองรับข้อความที่จัดรูปแบบ โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดรูปแบบข้อความในหัวข้อการจัดรูปแบบข้อความในแอป Google Chat และการจัดรูปแบบข้อความในส่วนเสริม Google Workspace
การแสดง JSON |
---|
{ "text": string } |
ช่อง | |
---|---|
text
|
|
รูปภาพ
รูปภาพที่ระบุโดย URL และมีสิทธิ์ดําเนินการ onclick
การแสดง JSON |
---|
{
"imageUrl": string,
"onClick": {
object (
|
ช่อง | |
---|---|
imageUrl
|
URL ของรูปภาพ |
onClick
|
การดําเนินการ |
aspectRatio
|
สัดส่วนภาพของรูปภาพนี้ (ความกว้างและความสูง) ช่องนี้ให้คุณจองความสูงที่เหมาะสมของรูปภาพในขณะที่รอการโหลด โดยไม่ได้ลบล้างสัดส่วนภาพที่มีอยู่ในรูปภาพ หากไม่ได้ตั้งค่า เซิร์ฟเวอร์จะเติมพื้นที่นั้นด้วยการดึงข้อมูลรูปภาพล่วงหน้า |
เมื่อคลิก
การดําเนินการ
onclick
(เช่น เปิดลิงก์)
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ช่อง Union
|
|
action
|
การทํางานของแบบฟอร์มจะทริกเกอร์โดยการดําเนินการ |
openLink
|
การดําเนินการ |
การทํางานของแบบฟอร์ม
การทํางานของแบบฟอร์มจะอธิบายลักษณะการทํางานเมื่อมีการส่งแบบฟอร์ม ตัวอย่างเช่น คุณจะเรียกใช้ Apps Script เพื่อจัดการกับแบบฟอร์มนั้นได้
การแสดง JSON |
---|
{
"actionMethodName": string,
"parameters": [
{
object (
|
ช่อง | |
---|---|
actionMethodName
|
ระบบจะใช้ชื่อเมธอดในการระบุว่าส่วนใดของแบบฟอร์มที่ทําให้เกิดการส่งแบบฟอร์ม ข้อมูลนี้จะสะท้อนกลับไปยังแอป Chat ซึ่งเป็นส่วนหนึ่งของกิจกรรมการคลิกการ์ด คุณอาจใช้ชื่อวิธีการเดียวกันสําหรับองค์ประกอบหลายรายการที่เรียกลักษณะการทํางานที่พบบ่อยได้ |
parameters[]
|
รายการพารามิเตอร์การกระทํา |
พารามิเตอร์การทํางาน
รายการพารามิเตอร์สตริงที่จะระบุเมื่อมีการเรียกใช้เมธอด เช่น ลองเลื่อนการปลุก 3 ครั้ง เลื่อนการปลุก 1 วัน เลื่อนการปลุกในสัปดาห์หน้า คุณอาจใช้ action method = snooze()
ซึ่งส่งประเภทไว้เตือนทีหลังและเลื่อนเวลาในรายการพารามิเตอร์สตริง
การแสดง JSON |
---|
{ "key": string, "value": string } |
ช่อง | |
---|---|
key
|
ชื่อพารามิเตอร์ของสคริปต์การดําเนินการ |
value
|
ค่าพารามิเตอร์ |
เปิดลิงก์
ลิงก์ที่เปิดหน้าต่างใหม่
การแสดง JSON |
---|
{ "url": string } |
ช่อง | |
---|---|
url
|
URL ที่จะเปิด |
คีย์-ค่า
องค์ประกอบ UI มีคีย์ (ป้ายกํากับ) และค่า (เนื้อหา) องค์ประกอบนี้อาจมีการกระทําบางอย่าง เช่น ปุ่ม onclick
การแสดง JSON |
---|
{ "topLabel": string, "content": string, "contentMultiline": boolean, "bottomLabel": string, "onClick": { object ( |
ช่อง | |
---|---|
topLabel
|
ข้อความของป้ายกํากับด้านบน รองรับข้อความที่จัดรูปแบบ โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดรูปแบบข้อความในหัวข้อการจัดรูปแบบข้อความในแอป Google Chat และการจัดรูปแบบข้อความในส่วนเสริม Google Workspace |
content
|
ข้อความของเนื้อหา รองรับข้อความที่จัดรูปแบบและจําเป็นต้องใช้เสมอ โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดรูปแบบข้อความในหัวข้อการจัดรูปแบบข้อความในแอป Google Chat และการจัดรูปแบบข้อความในส่วนเสริม Google Workspace |
contentMultiline
|
หากเนื้อหาควรเป็นแบบหลายบรรทัด |
bottomLabel
|
ข้อความของป้ายกํากับด้านล่าง รองรับข้อความที่จัดรูปแบบ โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดรูปแบบข้อความในหัวข้อการจัดรูปแบบข้อความในแอป Google Chat และการจัดรูปแบบข้อความในส่วนเสริม Google Workspace |
onClick
|
การดําเนินการ |
ช่อง Union
icons ต้องมีไอคอนอย่างน้อย 1 ไอคอน
top_label
และ
bottom_label
icons
ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
|
|
icon
|
ค่า Enum ที่แทนที่ด้วย Chat API ด้วยรูปภาพไอคอนที่เกี่ยวข้อง |
iconUrl
|
ไอคอนที่ระบุโดย URL |
ช่อง Union
control วิดเจ็ตควบคุม คุณสามารถตั้งค่า button หรือ switch_widget ก็ได้ แต่ไม่ใช่ทั้ง 2 อย่าง
control
ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
|
|
button
|
ปุ่มที่คลิกเพื่อทริกเกอร์การทํางานได้ |
Icon
ชุดไอคอนที่สนับสนุน
Enum | |
---|---|
ICON_UNSPECIFIED
|
|
AIRPLANE
|
|
BOOKMARK
|
|
BUS
|
|
CAR
|
|
CLOCK
|
|
CONFIRMATION_NUMBER_ICON
|
|
DOLLAR
|
|
DESCRIPTION
|
|
EMAIL
|
|
EVENT_PERFORMER
|
|
EVENT_SEAT
|
|
FLIGHT_ARRIVAL
|
|
FLIGHT_DEPARTURE
|
|
HOTEL
|
|
HOTEL_ROOM_TYPE
|
|
INVITE
|
|
MAP_PIN
|
|
MEMBERSHIP
|
|
MULTIPLE_PEOPLE
|
|
OFFER
|
|
PERSON
|
|
PHONE
|
|
RESTAURANT_ICON
|
|
SHOPPING_CART
|
|
STAR
|
|
STORE
|
|
TICKET
|
|
TRAIN
|
|
VIDEO_CAMERA
|
|
VIDEO_PLAY
|
ปุ่ม
ปุ่ม อาจเป็นปุ่มข้อความหรือปุ่มรูปภาพ
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ช่อง Union
|
|
textButton
|
ปุ่มที่มีข้อความและ
|
imageButton
|
ปุ่มที่มีรูปภาพและการกระทํา |
ปุ่มข้อความ
ปุ่มที่มีข้อความและ
onclick
การดําเนินการ
การแสดง JSON |
---|
{
"text": string,
"onClick": {
object (
|
ช่อง | |
---|---|
text
|
ข้อความของปุ่ม |
onClick
|
การดําเนินการ |
ปุ่มรูปภาพ
ปุ่มรูปภาพที่มีการดําเนินการ onclick
การแสดง JSON |
---|
{ "onClick": { object ( |
ช่อง | |
---|---|
onClick
|
การดําเนินการ |
name
|
ชื่อของ |
ช่อง Union
icons สามารถระบุไอคอนโดย
Icon
enum
หรือ URL
icons
ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
|
|
icon
|
ไอคอนที่ระบุโดย |
iconUrl
|
ไอคอนที่ระบุโดย URL |
แอ็กชันการ์ด
การดําเนินการของการ์ดคือการกระทําที่เชื่อมโยงกับการ์ด สําหรับบัตรใบแจ้งหนี้ การดําเนินการทั่วไปจะเป็นการลบใบแจ้งหนี้ ใบแจ้งหนี้ทางอีเมล หรือเปิดใบแจ้งหนี้ในเบราว์เซอร์
แอป Google Chat ไม่รองรับ
การแสดง JSON |
---|
{
"actionLabel": string,
"onClick": {
object (
|
ช่อง | |
---|---|
actionLabel
|
ป้ายกํากับที่เคยปรากฏในรายการเมนูการทํางาน |
onClick
|
การดําเนินการ onclick สําหรับรายการการทํางานนี้ |