OnClick

• การแสดง JSON
• OpenLink
  • การแสดง JSON
• OpenAs
• OnClose
• OverflowMenu
  • การแสดง JSON
• OverflowMenuItem
  • การแสดง JSON

แสดงวิธีตอบสนองเมื่อผู้ใช้คลิกองค์ประกอบแบบอินเทอร์แอกทีฟในการ์ด เช่น ปุ่ม

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

การแสดง JSON
{ "action": { object (Action) }, "openLink": { object (OpenLink) }, "openDynamicLinkAction": { object (Action) }, "card": { object (Card) }, "overflowMenu": { object (OverflowMenu) } }

ช่อง
ต่อไปนี้คือรายการช่องที่แยกกันโดยสิ้นเชิง ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
action	object (Action) หากระบุไว้ การดำเนินการจะทริกเกอร์โดย onClick นี้
openLink	object (OpenLink) หากระบุไว้ onClick นี้จะทริกเกอร์การดำเนินการเปิดลิงก์
openDynamicLinkAction	object (Action) ส่วนเสริมจะเรียกใช้การดำเนินการนี้เมื่อการดำเนินการนั้นต้องเปิดลิงก์ ซึ่งแตกต่างจาก openLink ด้านบนตรงที่ต้องสื่อสารกับเซิร์ฟเวอร์เพื่อรับลิงก์ ดังนั้น เว็บไคลเอ็นต์จึงต้องเตรียมการบางอย่างก่อนที่การตอบกลับการดำเนินการเปิดลิงก์จะกลับมา ใช้ได้กับส่วนเสริม Google Workspace และใช้ไม่ได้กับแอป Google Chat
card	object (Card) ระบบจะพุชการ์ดใหม่ไปยังสแต็กการ์ดหลังจากคลิกหากระบุไว้ ใช้ได้กับส่วนเสริม Google Workspace และใช้ไม่ได้กับแอป Google Chat
overflowMenu	object (OverflowMenu) หากระบุไว้ onClick นี้จะเปิดเมนูรายการเพิ่มเติม
สิ้นสุดฟิลด์ที่แยกกัน

OpenLink

แสดงเหตุการณ์ onClick ที่เปิดไฮเปอร์ลิงก์

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

การแสดง JSON
{ "url": string, "openAs": enum (OpenAs), "onClose": enum (OnClose) }

ช่อง
url	string URL ที่จะเปิด ระบบจะแปลง HTTP URL เป็น HTTPS
openAs	enum (OpenAs) วิธีเปิดลิงก์ ใช้ได้กับส่วนเสริม Google Workspace และใช้ไม่ได้กับแอป Google Chat
onClose	enum (OnClose) ไคลเอ็นต์จะลืมลิงก์หลังจากเปิดลิงก์หรือสังเกตลิงก์จนกว่าหน้าต่างจะปิดหรือไม่ ใช้ได้กับส่วนเสริม Google Workspace และใช้ไม่ได้กับแอป Google Chat

OpenAs

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

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

Enum
FULL_SIZE	ลิงก์จะเปิดเป็นหน้าต่างขนาดเต็ม (หากเป็นเฟรมที่ไคลเอ็นต์ใช้)
OVERLAY	ลิงก์จะเปิดเป็นภาพซ้อนทับ เช่น ป๊อปอัป

OnClose

สิ่งที่ไคลเอ็นต์ทำเมื่อลิงก์ที่เปิดโดยการดำเนินการ OnClick ถูกปิด

การติดตั้งใช้งานจะขึ้นอยู่กับความสามารถของแพลตฟอร์มไคลเอ็นต์ เช่น เว็บเบราว์เซอร์อาจเปิดลิงก์ในหน้าต่างป๊อปอัปที่มีแฮนเดิล OnClose

หากตั้งค่าทั้งแฮนเดิล OnOpen และ OnClose และแพลตฟอร์มไคลเอ็นต์ไม่รองรับทั้ง 2 ค่า OnClose จะมีความสำคัญเหนือกว่า

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

Enum
NOTHING	ค่าเริ่มต้น บัตรไม่โหลดซ้ำ ไม่มีอะไรเกิดขึ้น
RELOAD	โหลดการ์ดซ้ำหลังจากหน้าต่างย่อยปิดลง หากใช้ร่วมกับ OpenAs.OVERLAY หน้าต่างย่อยจะทำหน้าที่เป็นกล่องโต้ตอบโมดัลและการ์ดหลักจะถูกบล็อกจนกว่าหน้าต่างย่อยจะปิดลง

OverflowMenu

วิดเจ็ตที่แสดงเมนูป๊อปอัปที่มีการดำเนินการอย่างน้อย 1 รายการที่ผู้ใช้เรียกใช้ได้ เช่น การแสดงการดำเนินการที่ไม่ใช่การดำเนินการหลักในการ์ด คุณใช้วิดเจ็ตนี้ได้เมื่อการดำเนินการไม่พอดีกับพื้นที่ว่างที่มีอยู่ หากต้องการใช้ ให้ระบุวิดเจ็ตนี้ในการดำเนินการ OnClick ของวิดเจ็ตที่รองรับ เช่น ใน Button

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

การแสดง JSON
{ "items": [ { object (OverflowMenuItem) } ] }

ช่อง
items[]	object (OverflowMenuItem) ต้องระบุ รายการตัวเลือกเมนู

OverflowMenuItem

ตัวเลือกที่ผู้ใช้เรียกใช้ได้ในเมนูรายการเพิ่มเติม

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

การแสดง JSON
{ "startIcon": { object (Icon) }, "text": string, "onClick": { object (OnClick) }, "disabled": boolean }

ช่อง
startIcon	object (Icon) ไอคอนที่แสดงด้านหน้าข้อความ
text	string ต้องระบุ ข้อความที่ระบุหรืออธิบายสินค้าต่อผู้ใช้
onClick	object (OnClick) ต้องระบุ การดำเนินการที่เรียกใช้เมื่อเลือกตัวเลือกเมนู OnClick นี้ไม่สามารถมี OverflowMenu ได้ ระบบจะยกเลิก OverflowMenu ที่ระบุและปิดใช้รายการเมนู
disabled	boolean ตัวเลือกเมนูปิดใช้อยู่หรือไม่ ค่าเริ่มต้นคือ "เท็จ"