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

نماد سفارشی میزبانی‌شده در نشانی وب HTTPS را نمایش دهید.

برای مثال:

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

انواع فایل‌های پشتیبانی‌شده شامل .png و .jpg است.
materialIcon

object (MaterialIcon)

یکی از نمادهای Google Material را نمایش دهید.

برای مثال، برای نمایش نماد چارگوش انتخاب، از این کد استفاده کنید

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

برای برنامه‌های Google Chat دردسترس است و برای برافزاهای Google Workspace دردسترس نیست.
پایان فیلدهای متقابلاً انحصاری.

MaterialIcon

نماد Google Material که شامل بیش‌از ۲۵۰۰ گزینه است.

برای مثال، برای نمایش نماد چارگوش انتخاب با وزن و درجه سفارشی‌شده، این را بنویسید:

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

برای برنامه‌های Google Chat دردسترس است و برای برافزاهای Google Workspace دردسترس نیست.

نمایش JSON 
{
  "name": string,
  "fill": boolean,
  "weight": integer,
  "grade": integer
}
فیلدها
name

string

نام نماد تعریف‌شده در نماد Google Material، برای مثال، check_box. هر نام نامعتبری رها می‌شود و با رشته خالی جایگزین می‌شود و درنتیجه نماد پرداز نمی‌شود.
fill

boolean

اینکه نماد به‌صورت توپر ارائه شود یا نه. مقدار پیش‌فرض false است.

برای پیش‌دید تنظیمات مختلف نماد، به نمادهای قلم Google بروید و تنظیمات را در بخش سفارشی‌سازی اصلاح کنید.
weight

integer

ضخامت خط پیرامونی نماد. از {100،‏ 200،‏ 300،‏ 400،‏ 500،‏ 600،‏ 700} انتخاب کنید. اگر وجود نداشته باشد، مقدار پیش‌فرض ۴۰۰ است. اگر مقدار دیگری مشخص شود، از مقدار پیش‌فرض استفاده می‌شود.

برای پیش‌دید تنظیمات مختلف نماد، به نمادهای قلم Google بروید و تنظیمات را در بخش سفارشی‌سازی اصلاح کنید.
grade

integer

وزن و درجه بر ضخامت نماد تأثیر می‌گذارد. اصلاحات مربوط به نمره جزئی‌تر از اصلاحات مربوط به وزن است و تأثیر کمی بر اندازه نماد دارد. از بین {-25, 0, 200} انتخاب کنید. اگر وجود نداشته باشد، مقدار پیش‌فرض ۰ است. اگر مقدار دیگری مشخص شود، از مقدار پیش‌فرض استفاده می‌شود.

برای پیش‌دید تنظیمات مختلف نماد، به نمادهای قلم Google بروید و تنظیمات را در بخش سفارشی‌سازی اصلاح کنید.