Icon

סמל שמוצג בווידג'ט בכרטיס. דוגמה לאפליקציות ב-Google Chat מופיעה במאמר הוספת סמל.

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

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

ייצוג ב-JSON 
{
  "altText": string,
  "imageType": enum (ImageType),

  "knownIcon": string,
  "iconUrl": string,
  "materialIcon": {
    object (MaterialIcon)
  }
}
שדות
altText

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

enum (ImageType)

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

string

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

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

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

string

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

לדוגמה:

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

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

object (MaterialIcon)

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

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

"materialIcon": {
  "name": "check_box"
}

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

MaterialIcon

סמל של material של Google, שכולל יותר מ-2,500 אפשרויות.

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

{
  "name": "check_box",
  "fill": true,
  "weight": 300,
  "grade": -25
}

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

ייצוג ב-JSON 
{
  "name": string,
  "fill": boolean,
  "weight": integer,
  "grade": integer
}
שדות
name

string

שם הסמל שמוגדר ב-סמל של material של Google, לדוגמה, check_box. כל שם לא חוקי נמחק ומוחלף במחרוזת ריקה, והסמל לא מוצג.
fill

boolean

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

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

integer

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

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

integer

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

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