Cards v1

Card

การ์ดเป็นองค์ประกอบ UI ที่สามารถมีวิดเจ็ต UI ได้ เช่น ข้อความและรูปภาพ

การแสดง JSON
{
  "header": {
    object (CardHeader)
  },
  "sections": [
    {
      object (Section)
    }
  ],
  "cardActions": [
    {
      object (CardAction)
    }
  ],
  "name": string
}
ช่อง
header

object (CardHeader)

ส่วนหัวของการ์ด ปกติแล้วส่วนหัวจะมีชื่อและรูปภาพ

sections[]

object (Section)

ส่วนถูกคั่นด้วยตัวแบ่งบรรทัด

cardActions[]

object (CardAction)

การดําเนินการของการ์ดนี้

name

string

ชื่อการ์ด

ส่วนหัวของการ์ด

การแสดง JSON
{
  "title": string,
  "subtitle": string,
  "imageStyle": enum (ImageStyle),
  "imageUrl": string
}
ช่อง
title

string

ต้องระบุชื่อ ส่วนหัวมีความสูงคงที่คือหากระบุทั้งชื่อและคําบรรยาย แต่ละบรรทัดจะใช้ 1 บรรทัด หากมีการระบุแค่ชื่อวิดีโอ ชื่อจะแสดงภายในทั้ง 2 บรรทัด

subtitle

string

คําบรรยายในส่วนหัวของการ์ด

imageStyle

enum (ImageStyle)

ชนิดของรูปภาพ (เช่น เส้นขอบสี่เหลี่ยมจัตุรัสหรือเส้นขอบวงกลม)

imageUrl

string

URL ของรูปภาพในส่วนหัวของการ์ด

รูปแบบภาพ

Enum
IMAGE_STYLE_UNSPECIFIED
IMAGE เส้นขอบสี่เหลี่ยมจัตุรัส
AVATAR เส้นขอบวงกลม

ส่วน

ส่วนนี้ประกอบด้วยคอลเล็กชันของวิดเจ็ตที่แสดงผล (แนวตั้ง) ตามลําดับที่ระบุ ในทุกแพลตฟอร์ม การ์ดจะมีความกว้างคงที่ จึงไม่จําเป็นต้องใช้คุณสมบัติของการออกแบบ (เช่น float)

การแสดง JSON
{
  "header": string,
  "widgets": [
    {
      object (WidgetMarkup)
    }
  ]
}
ช่อง
header

string

ส่วนหัวของหัวข้อ รองรับข้อความที่จัดรูปแบบ โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดรูปแบบข้อความในหัวข้อการจัดรูปแบบข้อความในแอป Google Chat และการจัดรูปแบบข้อความในส่วนเสริม Google Workspace

widgets[]

object (WidgetMarkup)

ส่วนต้องมีวิดเจ็ตอย่างน้อย 1 รายการ

Widget ของมาร์กอัป

วิดเจ็ตคือองค์ประกอบ UI ที่แสดงข้อความและรูปภาพ

การแสดง JSON
{
  "buttons": [
    {
      object (Button)
    }
  ],

  // Union field data can be only one of the following:
  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "keyValue": {
    object (KeyValue)
  }
  // End of list of possible types for union field data.
}
ช่อง
buttons[]

object (Button)

รายการปุ่ม นอกจากนี้ ปุ่มต่างๆ ยังรวมถึง oneof data และตั้งค่าช่องใดช่องหนึ่งเท่านั้น

ช่อง Union data WidgetMarkup มีรายการใดรายการหนึ่งต่อไปนี้เท่านั้น คุณใช้ช่อง WidgetMarkup หลายช่องเพื่อแสดงรายการเพิ่มเติมได้ data ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
textParagraph

object (TextParagraph)

แสดงย่อหน้าข้อความในวิดเจ็ตนี้

image

object (Image)

แสดงภาพในวิดเจ็ตนี้

keyValue

object (KeyValue)

แสดงรายการคีย์-ค่าในวิดเจ็ตนี้

ย่อหน้าข้อความ

ย่อหน้าของข้อความ รองรับข้อความที่จัดรูปแบบ โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดรูปแบบข้อความในหัวข้อการจัดรูปแบบข้อความในแอป Google Chat และการจัดรูปแบบข้อความในส่วนเสริม Google Workspace

การแสดง JSON
{
  "text": string
}
ช่อง
text

string

รูปภาพ

รูปภาพที่ระบุโดย URL และมีสิทธิ์ดําเนินการ onclick

การแสดง JSON
{
  "imageUrl": string,
  "onClick": {
    object (OnClick)
  },
  "aspectRatio": number
}
ช่อง
imageUrl

string

URL ของรูปภาพ

onClick

object (OnClick)

การดําเนินการ onclick

aspectRatio

number

สัดส่วนภาพของรูปภาพนี้ (ความกว้างและความสูง) ช่องนี้ให้คุณจองความสูงที่เหมาะสมของรูปภาพในขณะที่รอการโหลด โดยไม่ได้ลบล้างสัดส่วนภาพที่มีอยู่ในรูปภาพ หากไม่ได้ตั้งค่า เซิร์ฟเวอร์จะเติมพื้นที่นั้นด้วยการดึงข้อมูลรูปภาพล่วงหน้า

เมื่อคลิก

การดําเนินการ onclick (เช่น เปิดลิงก์)

การแสดง JSON
{

  // Union field data can be only one of the following:
  "action": {
    object (FormAction)
  },
  "openLink": {
    object (OpenLink)
  }
  // End of list of possible types for union field data.
}
ช่อง

ช่อง Union data

data ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้

action

object (FormAction)

การทํางานของแบบฟอร์มจะทริกเกอร์โดยการดําเนินการonclickนี้หากระบุไว้

การทํางานของแบบฟอร์ม

การทํางานของแบบฟอร์มจะอธิบายลักษณะการทํางานเมื่อมีการส่งแบบฟอร์ม ตัวอย่างเช่น คุณจะเรียกใช้ Apps Script เพื่อจัดการกับแบบฟอร์มนั้นได้

การแสดง JSON
{
  "actionMethodName": string,
  "parameters": [
    {
      object (ActionParameter)
    }
  ]
}
ช่อง
actionMethodName

string

ระบบจะใช้ชื่อเมธอดในการระบุว่าส่วนใดของแบบฟอร์มที่ทําให้เกิดการส่งแบบฟอร์ม ข้อมูลนี้จะสะท้อนกลับไปยังแอป Chat ซึ่งเป็นส่วนหนึ่งของกิจกรรมการคลิกการ์ด คุณอาจใช้ชื่อวิธีการเดียวกันสําหรับองค์ประกอบหลายรายการที่เรียกลักษณะการทํางานที่พบบ่อยได้

parameters[]

object (ActionParameter)

รายการพารามิเตอร์การกระทํา

พารามิเตอร์การทํางาน

รายการพารามิเตอร์สตริงที่จะระบุเมื่อมีการเรียกใช้เมธอด เช่น ลองเลื่อนการปลุก 3 ครั้ง เลื่อนการปลุก 1 วัน เลื่อนการปลุกในสัปดาห์หน้า คุณอาจใช้ action method = snooze() ซึ่งส่งประเภทไว้เตือนทีหลังและเลื่อนเวลาในรายการพารามิเตอร์สตริง

การแสดง JSON
{
  "key": string,
  "value": string
}
ช่อง
key

string

ชื่อพารามิเตอร์ของสคริปต์การดําเนินการ

value

string

ค่าพารามิเตอร์

คีย์-ค่า

องค์ประกอบ UI มีคีย์ (ป้ายกํากับ) และค่า (เนื้อหา) องค์ประกอบนี้อาจมีการกระทําบางอย่าง เช่น ปุ่ม onclick

การแสดง JSON
{
  "topLabel": string,
  "content": string,
  "contentMultiline": boolean,
  "bottomLabel": string,
  "onClick": {
    object (OnClick)
  },

  // Union field icons can be only one of the following:
  "icon": enum (Icon),
  "iconUrl": string
  // End of list of possible types for union field icons.

  // Union field control can be only one of the following:
  "button": {
    object (Button)
  }
  // End of list of possible types for union field control.
}
ช่อง
topLabel

string

ข้อความของป้ายกํากับด้านบน รองรับข้อความที่จัดรูปแบบ โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดรูปแบบข้อความในหัวข้อการจัดรูปแบบข้อความในแอป Google Chat และการจัดรูปแบบข้อความในส่วนเสริม Google Workspace

content

string

ข้อความของเนื้อหา รองรับข้อความที่จัดรูปแบบและจําเป็นต้องใช้เสมอ โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดรูปแบบข้อความในหัวข้อการจัดรูปแบบข้อความในแอป Google Chat และการจัดรูปแบบข้อความในส่วนเสริม Google Workspace

contentMultiline

boolean

หากเนื้อหาควรเป็นแบบหลายบรรทัด

bottomLabel

string

ข้อความของป้ายกํากับด้านล่าง รองรับข้อความที่จัดรูปแบบ โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดรูปแบบข้อความในหัวข้อการจัดรูปแบบข้อความในแอป Google Chat และการจัดรูปแบบข้อความในส่วนเสริม Google Workspace

onClick

object (OnClick)

การดําเนินการ onclick เฉพาะป้ายกํากับด้านบน ป้ายกํากับล่าง และภูมิภาคของเนื้อหาเท่านั้นที่สามารถคลิกได้

ช่อง Union icons ต้องมีไอคอนอย่างน้อย 1 ไอคอน top_label และ bottom_label icons ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
icon

enum (Icon)

ค่า Enum ที่แทนที่ด้วย Chat API ด้วยรูปภาพไอคอนที่เกี่ยวข้อง

iconUrl

string

ไอคอนที่ระบุโดย URL

ช่อง Union control วิดเจ็ตควบคุม คุณสามารถตั้งค่า button หรือ switch_widget ก็ได้ แต่ไม่ใช่ทั้ง 2 อย่าง control ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
button

object (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 type can be only one of the following:
  "textButton": {
    object (TextButton)
  },
  "imageButton": {
    object (ImageButton)
  }
  // End of list of possible types for union field type.
}
ช่อง

ช่อง Union type

type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้

textButton

object (TextButton)

ปุ่มที่มีข้อความและ onclick การดําเนินการ

imageButton

object (ImageButton)

ปุ่มที่มีรูปภาพและการกระทําonclick

ปุ่มข้อความ

ปุ่มที่มีข้อความและ onclick การดําเนินการ

การแสดง JSON
{
  "text": string,
  "onClick": {
    object (OnClick)
  }
}
ช่อง
text

string

ข้อความของปุ่ม

onClick

object (OnClick)

การดําเนินการ onclick ของปุ่ม

ปุ่มรูปภาพ

ปุ่มรูปภาพที่มีการดําเนินการ onclick

การแสดง JSON
{
  "onClick": {
    object (OnClick)
  },
  "name": string,

  // Union field icons can be only one of the following:
  "icon": enum (Icon),
  "iconUrl": string
  // End of list of possible types for union field icons.
}
ช่อง
onClick

object (OnClick)

การดําเนินการ onclick

name

string

ชื่อของ imageButton ที่ใช้สําหรับการช่วยเหลือพิเศษ ค่าเริ่มต้นจะแสดงไว้หากไม่ได้ระบุชื่อนี้

ช่อง Union icons สามารถระบุไอคอนโดย Icon enum หรือ URL icons ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
icon

enum (Icon)

ไอคอนที่ระบุโดย enum ซึ่งบ่งบอกว่าเป็นไอคอนที่ได้จาก Chat API

iconUrl

string

ไอคอนที่ระบุโดย URL

แอ็กชันการ์ด

การดําเนินการของการ์ดคือการกระทําที่เชื่อมโยงกับการ์ด สําหรับบัตรใบแจ้งหนี้ การดําเนินการทั่วไปจะเป็นการลบใบแจ้งหนี้ ใบแจ้งหนี้ทางอีเมล หรือเปิดใบแจ้งหนี้ในเบราว์เซอร์

แอป Google Chat ไม่รองรับ

การแสดง JSON
{
  "actionLabel": string,
  "onClick": {
    object (OnClick)
  }
}
ช่อง
actionLabel

string

ป้ายกํากับที่เคยปรากฏในรายการเมนูการทํางาน

onClick

object (OnClick)

การดําเนินการ onclick สําหรับรายการการทํางานนี้