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) } }

שדות
ברשימה הבאה מופיעים שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים:
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 שתיפתח. כתובות 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 נסגר.

ההטמעה תלויה ביכולות של פלטפורמת הלקוח. לדוגמה, דפדפן אינטרנט עשוי לפתוח קישור בחלון קופץ עם handler של OnClose.

אם גם ה-handler של OnOpen וגם ה-handler של OnClose מוגדרים, והפלטפורמה של הלקוח לא תומכת בשני הערכים, OnClose מקבל עדיפות.

זמין לתוספים ל-Google Workspace ולא זמין לאפליקציות ל-Google Chat.

טיפוסים בני מנייה (enum)
NOTHING	ערך ברירת המחדל. הכרטיס לא נטען מחדש, לא קורה כלום.
RELOAD	טוען מחדש את הכרטיס אחרי שחלון הצאצא נסגר. אם משתמשים בו בשילוב עם OpenAs.OVERLAY, חלון הצאצא פועל כתיבת דו-שיח מודאלית והכרטיס הראשי נחסם עד שחלון הצאצא נסגר.

OverflowMenu

ווידג'ט שמציג תפריט קופץ עם פעולה אחת או יותר שהמשתמשים יכולים להפעיל. לדוגמה, הצגת פעולות לא ראשיות בכרטיס. אפשר להשתמש בווידג'ט הזה כשאין מספיק מקום לפעולות. כדי להשתמש בווידג'ט הזה, צריך לציין אותו בפעולה 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 אם האפשרות בתפריט מושבתת. ברירת המחדל היא False.