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 וכל ערך שמוגדר בשדה הזה נמחק.

סוג

זה שינוי אופציונלי. סוג הכפתור. אם השדה color מוגדר, הערך של type הוא בהכרח FILLED.

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

טיפוסים בני מנייה (enum)
TYPE_UNSPECIFIED אל תשתמשו בהם. לא צוין.
OUTLINED כפתורים עם מתאר הם כפתורים עם הדגשה בינונית. בדרך כלל הם מכילים פעולות חשובות, אבל לא את הפעולה העיקרית באפליקציה ל-Chat או בתוסף.
FILLED כפתור מלא כולל מארז עם צבע אחיד. הוא הכי בולט מבחינה ויזואלית, ומומלץ להשתמש בו לפעולה החשובה והעיקרית באפליקציה ל-Chat או בתוסף.
FILLED_TONAL כפתור מלא בצבע אחד הוא חלופה שמשלבת בין כפתור מלא לכפתור עם קו מתאר. הם שימושיים בהקשרים שבהם כפתור בעדיפות נמוכה יותר דורש קצת יותר דגש מאשר כפתור עם קו מתאר.
BORDERLESS לכפתור אין גורם מכיל בלתי נראה במצב ברירת המחדל שלו. הוא משמש לעיתים קרובות לפעולות בעדיפות הנמוכה ביותר, במיוחד כשמוצגות כמה אפשרויות.