Package google.apps.card.v1

string

פונקציה מותאמת אישית להפעלה כשמקלידים על הרכיב המכיל או מפעילים אותו בדרך אחרת.

דוגמה לשימוש מפורטת במאמר קריאת נתוני טפסים.

ActionParameter

רשימת הפרמטרים של הפעולה.

LoadIndicator

מציין את אינדיקטור הטעינה שיוצג בזמן הקריאה לפעולה.

bool

מציין אם ערכי הטופס נשארים לאחר הפעולה. ערך ברירת המחדל הוא false.

אם הערך הוא true, ערכי הטופס נשארים אחרי הפעלת הפעולה. כדי לאפשר למשתמש לבצע שינויים בזמן העיבוד של הפעולה, מגדירים את LoadIndicator לערך NONE. בהודעות בכרטיס באפליקציות Chat, צריך גם להגדיר את ResponseType של הפעולה כ-UPDATE_MESSAGE ולהשתמש באותו card_id מהכרטיס שהכיל את הפעולה.

אם הערך הוא false, ערכי הטופס יימחקו כשהפעולה מופעלת. כדי למנוע מהמשתמש לבצע שינויים בזמן העיבוד של הפעולה, מגדירים את LoadIndicator לערך SPINNER.

Interaction

אופציונלי. חובה כשפותחים תיבת דו-שיח.

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

אם לא מציינים אירוע, האפליקציה מגיבה על ידי ביצוע action – כמו פתיחת קישור או הפעלת פונקציה – כרגיל.

כשמציינים interaction, האפליקציה יכולה להגיב בדרכים אינטראקטיביות מיוחדות. לדוגמה, אם מגדירים את interaction כ-OPEN_DIALOG, האפליקציה יכולה לפתוח תיבת דו-שיח. כשהאפשרות הזו מוגדרת, אינדיקטור הטעינה לא מוצג. אם צוין עבור תוסף, כל הכרטיס יוסר ולא יוצג דבר בלקוח.

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

string

אופציונלי. ממלאים את הרשימה הזו בשמות של הווידג'טים שנדרשים לפעולה הזו כדי לשלוח אותה בצורה תקינה.

אם לווידג'טים שמפורטים כאן אין ערך כשהפעולה הזו מופעלת, שליחת הטופס מבוטלת.

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

bool

אופציונלי. אם הערך הזה נכון, כל הווידג'טים נחשבים כחובה לפעולה הזו.

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

string

שם הפרמטר של סקריפט הפעולה.

string

הערך של הפרמטר.

BorderType

סוג הגבול.

Color

הצבעים שבהם צריך להשתמש כשהסוג הוא BORDER_TYPE_STROKE.

כדי להגדיר את צבע הקו, מציינים ערך בשדות red,‏ green ו-blue. הערך חייב להיות מספר שרירותי (float) בין 0 ל-1 על סמך ערך הצבע RGB, כאשר 0 (0/255) מייצג את היעדר הצבע ו-1 (255/255) מייצג את העוצמה המקסימלית של הצבע.

לדוגמה, הקוד הבא מגדיר את הצבע לאדום בעוצמה המקסימלית:

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

השדה alpha לא זמין לצבע הקו. אם השדה הזה צוין, המערכת תתעלם ממנו.

int32

רדיוס הפינה של הגבול.

string

הטקסט שמוצג בתוך הלחצן.

Icon

סמל שמוצג בתוך הלחצן. אם גם icon וגם text מוגדרים, הסמל יופיע לפני הטקסט.

Color

אופציונלי. הצבע של הלחצן. אם ההגדרה מוגדרת, הלחצן type מוגדר ל-FILLED והצבע של השדות text ו-icon מוגדר לצבע מנוגד לשיפור הקריאוּת. לדוגמה, אם צבע הלחצן מוגדר ככחול, כל הטקסט או הסמלים בלחצן מוגדרים כלבנים.

כדי להגדיר את צבע הלחצן, מציינים ערך בשדות red,‏ green ו-blue. הערך חייב להיות מספר שרירותי (float) בין 0 ל-1 על סמך ערך הצבע RGB, כאשר 0 (0/255) מייצג את היעדר הצבע ו-1 (255/255) מייצג את העוצמה המקסימלית של הצבע.

לדוגמה, הקוד הבא מגדיר את הצבע לאדום בעוצמה המקסימלית:

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

השדה alpha לא זמין לצבע הכפתור. אם השדה הזה צוין, המערכת תתעלם ממנו.

OnClick

חובה. הפעולה שתתבצע כשמשתמש ילחץ על הלחצן, למשל פתיחת היפר-קישור או הפעלת פונקציה מותאמת אישית.

bool

אם הערך הוא true, הלחצן מוצג במצב לא פעיל ולא מגיב לפעולות של המשתמשים.

string

הטקסט החלופי שמשמש לצורכי נגישות.

מגדירים טקסט תיאורי שמאפשר למשתמשים לדעת מה הכפתור עושה. לדוגמה, אם לחיצה על לחצן פותחת היפר-קישור, אפשר לכתוב: "הלחצן פותח כרטיסייה חדשה בדפדפן ומנווט למסמכי העזרה למפתחים של Google Chat בכתובת https://developers.google.com/workspace/chat".

Type

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

Button

מערך של לחצנים.

CardHeader

הכותרת של הכרטיס. כותרת בדרך כלל מכילה תמונה ראשית וכותרת. הכותרות תמיד מופיעות בחלק העליון של הכרטיס.

Section

מכיל אוסף של ווידג'טים. לכל קטע יש כותרת אופציונלית משלו. החלקים מופרדים באופן חזותי באמצעות קו מפריד. דוגמה לאפליקציות של Google Chat מופיעה בקטע הגדרת קטע בכרטיס.

DividerStyle

סגנון המחיצה בין הכותרת, הקטעים והכותרת התחתונה.

CardAction

הפעולות של הכרטיס. הפעולות מתווספות לתפריט של סרגל הכלים של הכרטיס.

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

לדוגמה, ה-JSON הבא יוצר תפריט פעולות של כרטיס עם האפשרויות Settings ו-Send Feedback:

"card_actions": [
  {
    "actionLabel": "Settings",
    "onClick": {
      "action": {
        "functionName": "goToView",
        "parameters": [
          {
            "key": "viewType",
            "value": "SETTING"
         }
        ],
        "loadIndicator": "LoadIndicator.SPINNER"
      }
    }
  },
  {
    "actionLabel": "Send Feedback",
    "onClick": {
      "openLink": {
        "url": "https://example.com/feedback"
      }
    }
  }
]

string

שם הכרטיס. משמש כמזהה כרטיס בניווט בכרטיסים.

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

CardFixedFooter

הכותרת התחתונה הקבועה שמוצגת בתחתית הכרטיס הזה.

הגדרת fixedFooter בלי לציין primaryButton או secondaryButton גורמת לשגיאה. באפליקציות Chat, אפשר להשתמש בכותרות תחתונות קבועות בתיבות דו-שיח, אבל לא בהודעות בכרטיס.

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

DisplayStyle

בתוספים של Google Workspace, מגדיר את מאפייני התצוגה של peekCardHeader.

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

CardHeader

כשמוצג תוכן לפי הקשר, הכותרת של כרטיס התצוגה המקדימה משמשת כ-placeholder כדי שהמשתמש יוכל לנווט בין הכרטיסים בדף הבית לכרטיסים לפי הקשר.

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

string

התווית שמוצגת כפריט בתפריט הפעולות.

OnClick

הפעולה onClick של פריט הפעולה הזה.

Button

הלחצן הראשי של הכותרת התחתונה הקבועה. הכפתור חייב להיות כפתור טקסט עם טקסט וצבע מוגדרים.

Button

הלחצן המשני של הכותרת התחתונה הקבועה. הכפתור חייב להיות כפתור טקסט עם טקסט וצבע מוגדרים. אם השדה secondaryButton מוגדר, צריך להגדיר גם את השדה primaryButton.

string

חובה. הכותרת של כותרת הכרטיס. לכותרת יש גובה קבוע: אם מציינים גם כותרת וגם כותרת משנה, כל אחת מהן תופסת שורה אחת. אם מציינים רק את הכותרת, היא תופסת את שתי השורות.

string

כותרת המשנה של כותרת הכרטיס. אם מצוין, מופיע בשורה משלו מתחת ל-title.

ImageType

הצורה שבה התמונה חתוכה.

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

string

כתובת ה-URL מסוג HTTPS של התמונה בכותרת הכרטיס.

string

הטקסט החלופי של התמונה, שמשמש לצורכי נגישות.

TextParagraph

ווידג'ט של פסקה טקסט.

ButtonList

ווידג'ט של רשימת לחצנים.

Image

ווידג'ט תמונה.

string

טקסט שמופיע בחלק העליון של קטע. תמיכה בטקסט פשוט בפורמט HTML. מידע נוסף על עיצוב טקסט זמין במאמרים עיצוב טקסט באפליקציות של Google Chat ועיצוב טקסט בתוספים של Google Workspace.

Widget

כל הווידג'טים בקטע. צריך לכלול לפחות ווידג'ט אחד.

bool

מציין אם אפשר לכווץ את הקטע הזה.

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

כדי לקבוע אילו ווידג'טים יוסתרו, מציינים uncollapsibleWidgetsCount.

int32

מספר הווידג'טים שלא ניתן לכווץ, שנותרו גלויים גם כשקטע מסוים מכווץ.

לדוגמה, אם קטע מכיל חמישה ווידג'טים והערך של uncollapsibleWidgetsCount מוגדר כ-2, שני הווידג'טים הראשונים מוצגים תמיד והשלושה האחרונים מכווצים כברירת מחדל. הערך של uncollapsibleWidgetsCount נלקח בחשבון רק כאשר הערך של collapsible הוא true.

CollapseControl

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

CarouselCard

רשימה של כרטיסים שכלולים בקרוסלה.

NestedWidget

רשימה של ווידג'טים שמוצגים בכרטיס הקרוסלה. הווידג'טים מוצגים בסדר שבו הם צוינו.

NestedWidget

רשימה של ווידג'טים שמוצגת בחלק התחתון של כרטיס הקרוסלה. הווידג'טים מוצגים בסדר שבו הם צוינו.

Icon

תמונת הסמל. אם גם icon וגם text מוגדרים, הסמל יופיע לפני הטקסט.

string

הטקסט שמוצג בתוך הצ'יפ.

OnClick

אופציונלי. הפעולה שתתבצע כשמשתמש לוחץ על הצ'יפ, למשל פתיחת היפר-קישור או הפעלת פונקציה מותאמת אישית.

bool

אם הצ'יפ נמצא במצב פעיל ומגיב לפעולות של המשתמשים. ברירת המחדל היא true. הוצא משימוש. במקום זאת, אתם צריכים להשתמש ב-disabled.

bool

אם הצ'יפ נמצא במצב לא פעיל ומתעלם מפעולות של משתמשים. ברירת המחדל היא false.

string

הטקסט החלופי שמשמש לצורכי נגישות.

מגדירים טקסט תיאורי שמאפשר למשתמשים לדעת מהו תפקיד הצ'יפ. לדוגמה, אם צ'יפ פותח היפר-קישור, כותבים: "הצ'יפ פותח כרטיסייה חדשה בדפדפן ומנווט למסמכי העזרה למפתחים של Google Chat בכתובת https://developers.google.com/workspace/chat".

Layout

פריסת רשימת הצ'יפים שצוינה.

Chip

מערך של צ'יפים.

HorizontalAlignment

היישור האנכי של לחצן ההרחבה והכיווץ.

Button

אופציונלי. מגדירים לחצן בהתאמה אישית כדי להרחיב את הקטע. צריך להגדיר את השדות expand_button ו-collapse_button. רק קבוצת שדות אחת לא תכנס לתוקף. אם השדה הזה לא מוגדר, המערכת תשתמש בלחצן ברירת המחדל.

Button

אופציונלי. מגדירים לחצן מותאם אישית כדי לכווץ את הקטע. צריך להגדיר את השדות expand_button ו-collapse_button. רק קבוצת שדות אחת לא תכנס לתוקף. אם השדה הזה לא מוגדר, המערכת תשתמש בלחצן ברירת המחדל.

Column

מערך של עמודות. אפשר לכלול עד 2 עמודות בכרטיס או בתיבת דו-שיח.

HorizontalSizeStyle

מציין את האופן שבו עמודה ממלאת את רוחב הכרטיס.

HorizontalAlignment

קובע אם הווידג'טים ייטו לשמאל, לימין או למרכז העמודה.

VerticalAlignment

מציין אם ווידג'טים ייטו לחלק העליון, התחתון או המרכזי של העמודה.

Widgets

מערך של ווידג'טים שכלולים בעמודה. הווידג'טים מופיעים בסדר שבו הם צוינו.

TextParagraph

ווידג'ט ‏TextParagraph.

Image

ווידג'ט ‏Image.

DecoratedText

ווידג'ט ‏DecoratedText.

ButtonList

ווידג'ט ‏ButtonList.

TextInput

ווידג'ט ‏TextInput.

SelectionInput

ווידג'ט ‏SelectionInput.

DateTimePicker

ווידג'ט ‏DateTimePicker.

ChipList

ווידג'ט ‏ChipList.

string

השם שבו מזוהה השדה DateTimePicker באירוע של קלט בטופס.

פרטים על עבודה עם קלט של טפסים זמינים במאמר קבלת נתוני טפסים.

string

הטקסט שמבקש מהמשתמשים להזין תאריך, שעה או תאריך ושעה. לדוגמה, אם המשתמשים מתזמנים פגישה, אפשר להשתמש בתווית כמו Appointment date או Appointment date and time.

DateTimePickerType

האם הווידג'ט תומך בהזנת תאריך, שעה או תאריך ושעה.

int64

ערך ברירת המחדל שמוצג בווידג'ט, באלפיות שנייה מאז תחילת התקופה של זמן מערכת Unix.

מציינים את הערך בהתאם לסוג הבורר (DateTimePickerType):

• DATE_AND_TIME: תאריך ושעה לפי לוח השנה ב-UTC. לדוגמה, כדי לייצג את 1 בינואר 2023 בשעה 12:00 (חצות) לפי שעון UTC, משתמשים ב-1672574400000.
• DATE_ONLY: תאריך קלנדרי בשעה 00:00:00 (UTC). לדוגמה, כדי לייצג את התאריך 1 בינואר 2023, משתמשים ב-1672531200000.
• TIME_ONLY: שעה לפי שעון UTC. לדוגמה, כדי לייצג את השעה 12:00, משתמשים ב-43200000 (או ב-12 * 60 * 60 * 1000).

int32

המספר שמייצג את הסטייה של אזור הזמן משעון UTC, בדקות. אם ההגדרה מוגדרת, value_ms_epoch יוצג באזור הזמן שצוין. אם לא מגדירים ערך, הערך שמוגדר כברירת מחדל הוא אזור הזמן שהוגדר על ידי המשתמש.

Action

האירוע מופעל כשהמשתמש לוחץ על שמירה או על ניקוי בממשק DateTimePicker.

Icon

הוצא משימוש לטובת startIcon.

Icon

הסמל שמוצג לפני הטקסט.

string

הטקסט שמופיע מעל text. תמיד חותכים.

string

חובה. הטקסט הראשי.

יש תמיכה בעיצוב פשוט. מידע נוסף על עיצוב טקסט זמין במאמרים עיצוב טקסט באפליקציות של Google Chat ועיצוב טקסט בתוספים של Google Workspace.

bool

הגדרת גלישת הטקסט. אם הערך הוא true, הטקסט יתפרס בשורות מרובות. אחרת, הטקסט יקוצר.

ההנחה רלוונטית רק ל-text, ולא ל-topLabel ול-bottomLabel.

string

הטקסט שמופיע מתחת ל-text. תמיד מתבצעת גלישת תוכן.

OnClick

הפעולה הזו מופעלת כשמשתמשים לוחצים על topLabel או על bottomLabel.

Button

לחצן שמשתמש יכול ללחוץ עליו כדי להפעיל פעולה.

SwitchControl

ווידג'ט של מתג שמשתמשים יכולים ללחוץ עליו כדי לשנות את המצב שלו ולהפעיל פעולה.

Icon

סמל שמוצג אחרי הטקסט.

תמיכה בסמלים מובנים ומותאמים אישית.

string

השם שבו מזוהה הווידג'ט של המתג באירוע של קלט טופס.

פרטים על עבודה עם קלט של טפסים זמינים במאמר קבלת נתוני טפסים.

string

הערך שהוזן על ידי משתמש, מוחזר כחלק מאירוע קלט של טופס.

פרטים על עבודה עם קלט של טפסים זמינים במאמר קבלת נתוני טפסים.

bool

כשהערך הוא true, המתג נבחר.

Action

הפעולה שתתבצע כשמצב המתג ישתנה, למשל איזו פונקציה להריץ.

ControlType

איך המתג מופיע בממשק המשתמש.

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

string

הטקסט שמוצג בכותרת של התצוגה.

GridItem

הפריטים שיוצגו בתצוגת הרשת.

BorderStyle

סגנון המסגרת שיחול על כל פריט ברשת.

int32

מספר העמודות שיוצגו ברשת. אם לא מציינים ערך בשדה הזה, המערכת משתמשת בערך ברירת המחדל. ערך ברירת המחדל משתנה בהתאם למיקום שבו התצוגה של התרשים (תצוגת תיבת דו-שיח לעומת תצוגת שותף).

OnClick

כל פריט בנפרד ברשימה משתמש שוב ב-callback הזה, אבל המזהה והאינדקס של הפריט ברשימת הפריטים מתווספים לפרמטרים של ה-callback.

string

מזהה שהמשתמש מציין לפריט הזה בתצוגת הרשת. המזהה הזה מוחזר בפרמטרים של קריאה חוזרת (callback) onClick של רשת ההורה.

ImageComponent

התמונה שמוצגת בפריט התצוגה.

string

שם הפריט ברשימה.

string

כותרת המשנה של פריט התצוגה.

GridItemLayout

הפריסה שבה יש להשתמש בפריט התצוגה.

string

אופציונלי. תיאור של הסמל המשמש לנגישות. אם לא צוין ערך, המערכת תשתמש בערך ברירת המחדל Button. מומלץ להגדיר תיאור שימושי של מה שמוצג בסמל, ואם רלוונטי, מה הוא עושה. לדוגמה, A user's account portrait או Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/workspace/chat.

אם הסמל מוגדר ב-Button, ה-altText מופיע כטקסט עזר כאשר המשתמש מעביר את העכבר מעל הלחצן. עם זאת, אם הלחצן מגדיר גם את text, המערכת תתעלם מ-altText של הסמל.

ImageType

סגנון החיתוך שהוחל על התמונה. במקרים מסוימים, החלת חיתוך CIRCLE גורמת לכך שהתמונה תתואר גדולה יותר מסמל מובנה.

string

הצגת אחד מהסמלים המובנים ש-Google Workspace מספקת.

לדוגמה, כדי להציג סמל של מטוס, מציינים AIRPLANE. באוטובוס, מציינים BUS.

סמלים מובנים – רשימה מלאה של הסמלים הנתמכים.

string

הצגת סמל מותאם אישית שמתארח בכתובת URL מסוג HTTPS.

לדוגמה:

"iconUrl":
"https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png"

סוגי הקבצים הנתמכים כוללים .png ו-.jpg.

MaterialIcon

להציג אחד מסמלי Google Material.

לדוגמה, כדי להציג סמל של תיבת סימון, משתמשים ב-

"material_icon": {
  "name": "check_box"
}

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

string

כתובת ה-URL מסוג HTTPS שמארחת את התמונה.

לדוגמה:

https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png

OnClick

כשמשתמש לוחץ על התמונה, הקליק מפעיל את הפעולה הזו.

string

הטקסט החלופי של התמונה, שמשמש לצורכי נגישות.

string

כתובת ה-URL של התמונה.

string

תווית הנגישות של התמונה.

ImageCropStyle

סגנון החיתוך שיחול על התמונה.

BorderStyle

סגנון הגבול שיחול על התמונה.

ImageCropType

סוג החיתוך.

double

יחס הגובה-רוחב שבו יש להשתמש אם סוג החיתוך הוא RECTANGLE_CUSTOM.

לדוגמה, כך מחילים יחס גובה-רוחב של 16:9:

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}

string

שם הסמל שמוגדר בסמל Google Material, לדוגמה check_box. שמות לא חוקיים לא נשמרים ומוחלפים במחרוזת ריקה, וכתוצאה מכך אי אפשר להציג את הסמל.

bool

האם הסמל מוצג כסמל מלא. ערך ברירת המחדל הוא false.

כדי לראות תצוגה מקדימה של הגדרות שונות של סמלים, עוברים אל סמלי פונטים של Google ומשנים את ההגדרות בקטע התאמה אישית.

int32

עובי הקו של הסמל. בוחרים מתוך {100, 200, 300, 400, 500, 600, 700}. אם השדה לא קיים, ערך ברירת המחדל הוא 400. אם יצוין ערך אחר, המערכת תשתמש בערך ברירת המחדל.

כדי לראות תצוגה מקדימה של הגדרות שונות של סמלים, עוברים אל סמלי פונטים של Google ומשנים את ההגדרות בקטע התאמה אישית.

int32

העובי של הסמל מושפע מהמשקל ומהסיווג. שינויים בציון הם מפורטים יותר משינויים במשקל, והם משפיעים במידה קטנה על גודל הסמל. בוחרים מתוך {-25, 0, 200}. אם הערך חסר, ערך ברירת המחדל הוא 0. אם יצוין ערך אחר, המערכת תשתמש בערך ברירת המחדל.

כדי לראות תצוגה מקדימה של הגדרות שונות של סמלים, עוברים אל סמלי פונטים של Google ומשנים את ההגדרות בקטע התאמה אישית.

Action

אם מצוין, הפעולה מופעלת על ידי onClick הזה.

OpenLink

אם מצוין, onClick מפעיל פעולת פתיחת קישור.

Action

תוסף מפעיל את הפעולה הזו כשהפעולה צריכה לפתוח קישור. ההבדל בין האפשרות הזו לבין האפשרות open_link שלמעלה הוא שהאפשרות הזו צריכה לתקשר עם השרת כדי לקבל את הקישור. לכן, לקוח האינטרנט צריך לבצע עבודת הכנה מסוימת לפני שתתקבל התשובה לפעולה של פתיחת הקישור.

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

Card

כרטיס חדש נדחף לערימה אחרי לחיצה, אם צוין כך.

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

OverflowMenu

אם מציינים את האפשרות הזו, onClick פותח תפריט אפשרויות נוסף.

string

כתובת ה-URL שרוצים לפתוח.

OpenAs

איך פותחים קישור.

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

OnClose

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

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

OverflowMenuItem

חובה. רשימת אפשרויות התפריט.

Icon

הסמל שמוצג לפני הטקסט.

string

חובה. הטקסט שמזהה או מתאר את הפריט למשתמשים.

OnClick

חובה. הפעולה שמתבצעת כשבוחרים אפשרות בתפריט. ה-OnClick הזה לא יכול להכיל OverflowMenu, כל OverflowMenu שצוין יושלך ופריט התפריט יושבת.

bool

אם אפשרות התפריט מושבתת. ברירת המחדל היא false.

string

חובה. השם שמזהה את קלט הבחירה באירוע קלט של טופס.

פרטים על עבודה עם קלט של טפסים זמינים במאמר קבלת נתוני טפסים.

string

הטקסט שמופיע מעל שדה הקלט של הבחירה בממשק המשתמש.

מציינים טקסט שיעזור למשתמש להזין את המידע הנדרש לאפליקציה. לדוגמה, אם המשתמשים בוחרים את מידת הדחיפות של כרטיס עבודה מתפריט נפתח, התווית עשויה להיות 'דחיפות' או 'בחירת דחיפות'.

SelectionType

סוג הפריטים שמוצגים למשתמשים בווידג'ט SelectionInput. סוגי הבחירה תומכים בסוגים שונים של אינטראקציות. לדוגמה, משתמשים יכולים לסמן תיבה אחת או יותר, אבל הם יכולים לבחור רק ערך אחד מתפריט נפתח.

SelectionItem

מערך של פריטים לבחירה. לדוגמה, מערך של לחצני רדיו או תיבות סימון. יש תמיכה בעד 100 פריטים.

Action

אם יצוין, הטופס יישלח כשהבחירה תשתנה. אם לא מציינים את האפשרות הזו, צריך לציין לחצן נפרד לשליחת הטופס.

פרטים על עבודה עם קלט של טפסים זמינים במאמר קבלת נתוני טפסים.

int32

בתפריטים עם אפשרות לבחירת מספר פריטים, המספר המקסימלי של פריטים שמשתמש יכול לבחור. הערך המינימלי הוא פריט אחד. אם לא צוין ערך, ברירת המחדל היא 3 פריטים.

int32

בתפריטים עם אפשרות לבחירת מספר פריטים, מספר התווים בטקסט שהמשתמש מזין לפני שהתפריט מחזיר הצעות לפריטים לבחירה.

אם לא מגדירים את הערכים האלה, תפריט הבחירה בכמה פריטים ישתמש בערכי ברירת המחדל הבאים:

• אם בתפריט נעשה שימוש במערך סטטי של פריטים מסוג SelectionInput, הערך שמוגדר כברירת מחדל הוא 0 תווים והפריטים מהמערך מאוכלסים באופן מיידי.
• אם התפריט משתמש במקור נתונים דינמי (multi_select_data_source), ברירת המחדל היא 3 תווים לפני שליחת שאילתה למקור הנתונים כדי להציג את הפריטים המוצעים.

Action

מקור נתונים חיצוני, כמו מסד נתונים יחסיים.

PlatformDataSource

מקור נתונים מ-Google Workspace.

CommonDataSource

מקור נתונים שמשותף לכל האפליקציות של Google Workspace, כמו משתמשים בארגון ב-Google Workspace.

HostAppDataSourceMarkup

מקור נתונים ייחודי לאפליקציית מארח ב-Google Workspace, כמו מרחבים משותפים ב-Google Chat.

השדה הזה תומך בספריות הלקוח של Google API, אבל הוא לא זמין בספריות הלקוח ב-Cloud. מידע נוסף זמין במאמר התקנת ספריות הלקוח.

string

הטקסט שמזהה או מתאר את הפריט למשתמשים.

string

הערך שמשויך לפריט הזה. הלקוח צריך להשתמש בערך הזה כערך קלט בטופס.

פרטים על עבודה עם קלט של טפסים זמינים במאמר קבלת נתוני טפסים.

bool

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

string

בתפריטים עם אפשרות לבחירת מספר פריטים, כתובת ה-URL של הסמל שמוצג לצד השדה text של הפריט. יש תמיכה בקובצי PNG ו-JPEG. חייבת להיות כתובת URL מסוג HTTPS. לדוגמה, https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png.

string

בתפריטים עם אפשרות לבחירת מספר פריטים, תווית או תיאור טקסט שמוצגים מתחת לשדה text של הפריט.

SuggestionItem

רשימה של הצעות שמשמשות להמלצות להשלמה אוטומטית בשדות להזנת טקסט.

string

הערך של הצעת קלט לשדה קלט טקסט. זהו השם שהמשתמשים מזינים בעצמם.

string

השם שבו מזוהה הקלט של הטקסט באירוע של קלט טופס.

פרטים על עבודה עם קלט של טפסים זמינים במאמר קבלת נתוני טפסים.

string

הטקסט שמופיע מעל שדה הקלט של הטקסט בממשק המשתמש.

מציינים טקסט שיעזור למשתמש להזין את המידע הנדרש לאפליקציה. לדוגמה, אם אתם שואלים את השם של מישהו, אבל אתם צריכים במיוחד את שם המשפחה שלו, עליכם לכתוב surname במקום name.

חובה אם לא צוין ערך בשדה hintText. אחרת, אופציונלי.

string

טקסט שמופיע מתחת לשדה להזנת טקסט, שנועד לעזור למשתמשים על ידי הנחיה להזין ערך מסוים. הטקסט הזה תמיד גלוי.

חובה אם לא צוין ערך בשדה label. אחרת, אופציונלי.

string

הערך שהוזן על ידי משתמש, מוחזר כחלק מאירוע קלט של טופס.

פרטים על עבודה עם קלט של טפסים זמינים במאמר קבלת נתוני טפסים.

Type

איך שדה להזנת טקסט מופיע בממשק המשתמש. לדוגמה, אם השדה הוא שורה אחת או כמה שורות.

Action

מה עושים כשמתרחש שינוי בשדה הקלט של הטקסט. לדוגמה, משתמש שמוסיף לשדה או מחק טקסט.

דוגמאות לפעולות שאפשר לבצע הן הפעלת פונקציה מותאמת אישית או פתיחת תיבת דו-שיח ב-Google Chat.

Suggestions

הצעות לערכים שהמשתמשים יכולים להזין. הערכים האלה מופיעים כשמשתמשים לוחצים בתוך שדה הקלט של הטקסט. כשהמשתמשים מקלידים, המערכת מסננת באופן דינמי את ההצעות כך שיתאימו למה שהמשתמשים הקלידו.

לדוגמה, שדה קלט טקסט לשפת תכנות עשוי להציע את השפות Java‏, JavaScript‏, Python ו-C++‎. כשמשתמשים מתחילים להקליד Jav, רשימת ההצעות מסוננת כך שתוצג רק Java ו-JavaScript.

הצעות לערכים עוזרות למשתמשים להזין ערכים שהאפליקציה שלכם יכולה להבין. כשמדברים על JavaScript, חלק מהמשתמשים עשויים להזין javascript וחלקם java script. הצגת הצעות ל-JavaScript יכולה לסטנדרטיזציה את האינטראקציה של המשתמשים עם האפליקציה.

כשמציינים את הערך, TextInput.type הוא תמיד SINGLE_LINE, גם אם הוא מוגדר כ-MULTIPLE_LINE.

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

Action

אופציונלי. מציינים איזו פעולה תתבצע כששדה הקלט של הטקסט יציג הצעות למשתמשים שמקיימים איתו אינטראקציה.

אם לא מציינים ערך, ההצעות מוגדרות על ידי initialSuggestions ומעובדות על ידי הלקוח.

אם יצוין, האפליקציה תבצע את הפעולה שצוינה כאן, למשל הפעלת פונקציה מותאמת אישית.

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

Validation

מציינים את אימות פורמט הקלט הנדרש לשדה הטקסט הזה.

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

string

טקסט שמופיע בשדה להזנת טקסט כשהשדה ריק. משתמשים בטקסט הזה כדי לבקש מהמשתמשים להזין ערך. לדוגמה, Enter a number from 0 to 100.

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

string

הטקסט שמוצג בווידג'ט.

int32

מספר השורות המקסימלי של הטקסט שמוצג בווידג'ט. אם הטקסט חורג ממספר השורות המקסימלי שצוין, התוכן העודף מוסתר מאחורי הלחצן הצגת עוד. אם הטקסט שווה למספר השורות המקסימלי שצוין או קצר ממנו, לא יוצג לחצן הצגת עוד.

ערך ברירת המחדל הוא 0, ובמקרה כזה כל ההקשר מוצג. המערכת מתעלמת מערכים שליליים.

int32

ציון מגבלת התווים של ווידג'טים של קלט טקסט. שימו לב שהאפשרות הזו משמשת רק לקלט טקסט, והיא מתעלמת מווידג'טים אחרים.

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

InputType

מציינים את הסוג של ווידג'טים הקלט.

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

HorizontalAlignment

קובע אם הווידג'טים ייטו לשמאל, לימין או למרכז העמודה.

TextParagraph

הצגת פסקה של טקסט. תמיכה בטקסט פשוט בפורמט HTML. מידע נוסף על עיצוב טקסט זמין במאמרים עיצוב טקסט באפליקציות של Google Chat ועיצוב טקסט בתוספים של Google Workspace.

לדוגמה, הקוד הבא יוצר טקסט מודגש:

"textParagraph": {
  "text": "  <b>bold text</b>"
}

Image

הצגת תמונה.

לדוגמה, הקוד הבא ב-JSON יוצר תמונה עם טקסט חלופי:

"image": {
  "imageUrl":
  "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
  "altText": "Chat app avatar"
}

DecoratedText

הצגת פריט טקסט מעוטר.

לדוגמה, הקוד הבא יוצר ווידג'ט טקסט מעוטר שמוצגת בו כתובת אימייל:

"decoratedText": {
  "icon": {
    "knownIcon": "EMAIL"
  },
  "topLabel": "Email Address",
  "text": "sasha@example.com",
  "bottomLabel": "This is a new Email address!",
  "switchControl": {
    "name": "has_send_welcome_email_to_sasha",
    "selected": false,
    "controlType": "CHECKBOX"
  }
}

ButtonList

רשימת לחצנים.

לדוגמה, הקוד הבא ב-JSON יוצר שני לחצנים. הראשון הוא לחצן טקסט כחול והשני הוא לחצן תמונה שפותח קישור:

"buttonList": {
  "buttons": [
    {
      "text": "Edit",
      "color": {
        "red": 0,
        "green": 0,
        "blue": 1,
      },
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}

TextInput

הצגת תיבת טקסט שמשתמשים יכולים להקליד בה.

לדוגמה, ה-JSON הבא יוצר קלט טקסט לכתובת אימייל:

"textInput": {
  "name": "mailing_address",
  "label": "Mailing Address"
}

דוגמה נוספת: הקוד הבא ב-JSON יוצר קלט טקסט של שפת תכנות עם הצעות סטטיות:

"textInput": {
  "name": "preferred_programing_language",
  "label": "Preferred Language",
  "initialSuggestions": {
    "items": [
      {
        "text": "C++"
      },
      {
        "text": "Java"
      },
      {
        "text": "JavaScript"
      },
      {
        "text": "Python"
      }
    ]
  }
}

SelectionInput

הצגת רכיב בקרה לבחירה שמאפשר למשתמשים לבחור פריטים. אמצעי הבקרה לבחירה יכולים להיות תיבות סימון, לחצני בחירה, מתגים או תפריטים נפתחים.

לדוגמה, ה-JSON הבא יוצר תפריט נפתח שמאפשר למשתמשים לבחור גודל:

"selectionInput": {
  "name": "size",
  "label": "Size"
  "type": "DROPDOWN",
  "items": [
    {
      "text": "S",
      "value": "small",
      "selected": false
    },
    {
      "text": "M",
      "value": "medium",
      "selected": true
    },
    {
      "text": "L",
      "value": "large",
      "selected": false
    },
    {
      "text": "XL",
      "value": "extra_large",
      "selected": false
    }
  ]
}

DateTimePicker

הצגת ווידג'ט שמאפשר למשתמשים להזין תאריך, שעה או תאריך ושעה.

לדוגמה, ה-JSON הבא יוצר בורר תאריך ושעה לתזמון פגישה:

"dateTimePicker": {
  "name": "appointment_time",
  "label": "Book your appointment at:",
  "type": "DATE_AND_TIME",
  "valueMsEpoch": "796435200000"
}

Divider

הצגת קו אופקי מפריד בין ווידג'טים.

לדוגמה, הקוד הבא יוצר מפריד:

"divider": {
}

Grid

הצגת רשת עם אוסף פריטים.

אפשר להוסיף לרשת כל מספר של עמודות ופריטים. מספר השורות נקבע לפי המגבלה העליונה של מספר הפריטים חלקי מספר העמודות. לרשת עם 10 פריטים ו-2 עמודות יש 5 שורות. לרשת עם 11 פריטים ו-2 עמודות יש 6 שורות.

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

לדוגמה, ה-JSON הבא יוצר רשת של 2 עמודות עם פריט אחד:

"grid": {
  "title": "A fine collection of items",
  "columnCount": 2,
  "borderStyle": {
    "type": "STROKE",
    "cornerRadius": 4
  },
  "items": [
    {
      "image": {
        "imageUri": "https://www.example.com/image.png",
        "cropStyle": {
          "type": "SQUARE"
        },
        "borderStyle": {
          "type": "STROKE"
        }
      },
      "title": "An item",
      "textAlignment": "CENTER"
    }
  ],
  "onClick": {
    "openLink": {
      "url": "https://www.example.com"
    }
  }
}

Columns

מוצגות עד 2 עמודות.

כדי לכלול יותר מ-2 עמודות או להשתמש בשורות, משתמשים בווידג'ט Grid.

לדוגמה, ה-JSON הבא יוצר 2 עמודות, שכל אחת מהן מכילה פסקאות טקסט:

"columns": {
  "columnItems": [
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "First column text paragraph"
          }
        }
      ]
    },
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "Second column text paragraph"
          }
        }
      ]
    }
  ]
}

Carousel

קרוסלה מכילה אוסף של ווידג'טים בתצוגת עץ. לדוגמה, זהו ייצוג JSON של קרוסלה שמכילה שני פסקאות טקסט.

{
  "widgets": [
    {
      "textParagraph": {
        "text": "First text paragraph in the carousel."
      }
    },
    {
      "textParagraph": {
        "text": "Second text paragraph in the carousel."
      }
    }
  ]
}

ChipList

רשימה של צ'יפים.

לדוגמה, הקוד הבא ב-JSON יוצר שני צ'יפים. הראשון הוא צ'יפ טקסט והשני הוא צ'יפ סמל שפותח קישור:

"chipList": {
  "chips": [
    {
      "text": "Edit",
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}