Button

ข้อความ ไอคอน หรือปุ่มข้อความและไอคอนที่ผู้ใช้คลิกได้ ดูตัวอย่างในแอป Google Chat ได้ที่หัวข้อเพิ่มปุ่ม

หากต้องการทำให้รูปภาพเป็นปุ่มที่คลิกได้ ให้ระบุ Image (ไม่ใช่ ImageComponent) และตั้งค่าการดำเนินการ onClick

พร้อมใช้งานสำหรับแอป Google Chat และส่วนเสริม Google Workspace

การแสดง JSON 
{
  "text": string,
  "icon": {
    object (Icon)
  },
  "color": {
    object (Color)
  },
  "onClick": {
    object (OnClick)
  },
  "disabled": boolean,
  "altText": string,
  "type": enum (Type)
}
ช่อง
text

string

ข้อความที่แสดงภายในปุ่ม
icon

object (Icon)

ไอคอนที่แสดงภายในปุ่ม หากตั้งค่าทั้ง icon และ text ไอคอนจะปรากฏก่อนข้อความ
color

object (Color)

ไม่บังคับ สีของปุ่ม หากตั้งค่าไว้ ปุ่ม type จะตั้งค่าเป็น FILLED และสีของช่อง text และ icon จะตั้งค่าเป็นสีที่ตัดกันเพื่อให้อ่านง่าย เช่น หากตั้งค่าสีปุ่มเป็นสีน้ำเงิน ระบบจะตั้งค่าข้อความหรือไอคอนในปุ่มเป็นสีขาว

หากต้องการตั้งค่าสีปุ่ม ให้ระบุค่าสำหรับช่อง red, green และ blue ค่าต้องเป็นเลขจำนวนจริงระหว่าง 0 ถึง 1 โดยอิงตามค่าสี RGB ซึ่ง 0 (0/255) หมายถึงไม่มีสี และ 1 (255/255) หมายถึงความเข้มสูงสุดของสี

ตัวอย่างเช่น โค้ดต่อไปนี้จะตั้งค่าสีเป็นสีแดงที่ความเข้มสูงสุด

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
}

ช่อง alpha ใช้กับสีของปุ่มไม่ได้ หากระบุ ระบบจะไม่สนใจช่องนี้
onClick

object (OnClick)

ต้องระบุ การดำเนินการที่จะทำเมื่อผู้ใช้คลิกปุ่ม เช่น การเปิดไฮเปอร์ลิงก์หรือการเรียกใช้ฟังก์ชันที่กำหนดเอง
disabled

boolean

หาก true ปุ่มจะแสดงในสถานะไม่ทำงานและไม่ตอบสนองต่อการดำเนินการของผู้ใช้
altText

string

ข้อความสำรองที่ใช้สำหรับการช่วยเหลือพิเศษ

ตั้งค่าข้อความอธิบายที่ช่วยให้ผู้ใช้ทราบว่าปุ่มทำอะไรได้บ้าง เช่น หากปุ่มเปิดไฮเปอร์ลิงก์ คุณอาจเขียนว่า "เปิดแท็บเบราว์เซอร์ใหม่และไปยังเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์ Google Chat ที่ https://developers.google.com/workspace/chat"
type

enum (Type)

ไม่บังคับ ประเภทของปุ่ม หากไม่ได้ตั้งค่าไว้ ประเภทปุ่มจะใช้ค่าเริ่มต้นเป็น OUTLINED หากตั้งค่าช่อง color ไว้ ระบบจะบังคับให้ประเภทปุ่มเป็น FILLED และจะไม่สนใจค่าที่ตั้งไว้สำหรับช่องนี้

ประเภท

ไม่บังคับ type ของปุ่ม หากตั้งค่าช่อง color ระบบจะบังคับให้ type เป็น FILLED

ใช้ได้กับแอป Google Chat และใช้ไม่ได้กับส่วนเสริม Google Workspace

Enum
TYPE_UNSPECIFIED ไม่ใช้ ไม่ระบุ
OUTLINED ปุ่มแบบมีเส้นขอบเป็นปุ่มที่เน้นระดับปานกลาง โดยปกติแล้วเมนูนี้จะมีการดำเนินการที่สำคัญ แต่ไม่ใช่การดำเนินการหลักในแอปใน Chat หรือส่วนเสริม
FILLED ปุ่มแบบทึบมีคอนเทนเนอร์ที่มีสีทึบ ปุ่มนี้มีผลต่อการมองเห็นมากที่สุด และเราขอแนะนำให้ใช้สำหรับการดำเนินการที่สำคัญและหลักในแอปใน Chat หรือส่วนเสริม
FILLED_TONAL ปุ่มแบบเติมสีโทนเดียวเป็นทางเลือกที่อยู่กึ่งกลางระหว่างปุ่มแบบเติมสีและปุ่มแบบมีเส้นขอบ ซึ่งมีประโยชน์ในบริบทที่ปุ่มที่มีลำดับความสำคัญต่ำกว่าต้องการการเน้นมากกว่าปุ่มแบบเส้นขอบเล็กน้อย
BORDERLESS ปุ่มไม่มีคอนเทนเนอร์ที่มองไม่เห็นในสถานะเริ่มต้น มักใช้สำหรับการดำเนินการที่มีลำดับความสำคัญต่ำสุด โดยเฉพาะเมื่อแสดงตัวเลือกหลายรายการ