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)

عرض أحد رموز Google Material:

على سبيل المثال، لعرض رمز مربّع اختيار، استخدِم

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

متاحة لتطبيقات Google Chat وغير متاحة لإضافات Google Workspace.
نهاية الحقول التي يستبعد كلّ منها الآخر

MaterialIcon

رمز متوافق مع إرشادات التصميم المتعدّد الأبعاد من Google، والذي يتضمّن أكثر من 2500 خيار

على سبيل المثال، لعرض رمز مربّع اختيار بسمك ودرجة مخصّصَين، اكتب ما يلي:

{
  "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، على سبيل المثال، check_box. يتم تجاهل أي أسماء غير صالحة واستبدالها بسلسلة فارغة، ما يؤدي إلى تعذُّر عرض الرمز.
fill

boolean

ما إذا كان الرمز يظهر ممتلئًا القيمة التلقائية هي false.

لمعاينة إعدادات الرموز المختلفة، انتقِل إلى رموز Google Fonts واضبط الإعدادات ضمن تخصيص.
weight

integer

كثافة خط الرسم للرمز يمكنك الاختيار من بين {100, 200, 300, 400, 500, 600, 700}. في حال عدم توفّرها، تكون القيمة التلقائية هي 400. في حال تحديد أي قيمة أخرى، يتم استخدام القيمة التلقائية.

لمعاينة إعدادات الرموز المختلفة، انتقِل إلى رموز Google Fonts واضبط الإعدادات ضمن تخصيص.
grade

integer

يؤثر الوزن والدرجة في سُمك الرمز. تكون التعديلات على الدرجة أكثر دقة من التعديلات على الوزن، ويكون لها تأثير بسيط على حجم الرمز. اختَر من بين {-25, 0, 200}. في حال عدم توفّرها، تكون القيمة التلقائية هي 0. في حال تحديد أي قيمة أخرى، يتم استخدام القيمة التلقائية.

لمعاينة إعدادات الرموز المختلفة، انتقِل إلى رموز Google Fonts واضبط الإعدادات ضمن تخصيص.