SelectionItem

عنصر يمكن للمستخدمين اختياره في إدخال اختيار، مثل مربّع اختيار أو مفتاح تبديل. يمكن استخدام ما يصل إلى 100 عنصر.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

تمثيل JSON
{
  "text": string,
  "value": string,
  "selected": boolean,
  "bottomText": string,

  "startIconUri": string
}
الحقول
text

string

النص الذي يحدّد العنصر أو يصفه للمستخدمين.

value

string

القيمة المرتبطة بهذا العنصر يجب أن يستخدم العميل هذه القيمة كقيمة إدخال في النموذج.

للحصول على تفاصيل حول العمل مع إدخالات النماذج، يُرجى الاطّلاع على تلقّي بيانات النماذج.

selected

boolean

ما إذا كان العنصر محدّدًا تلقائيًا إذا كان إدخال الاختيار يقبل قيمة واحدة فقط (مثل أزرار الاختيار أو القائمة المنسدلة)، اضبط هذا الحقل لعنصر واحد فقط.

bottomText

string

بالنسبة إلى القوائم المتعددة الاختيارات، يمثّل هذا الحقل وصفًا نصيًا أو تصنيفًا يتم عرضه أسفل حقل text للعنصر.

بالنسبة إلى قوائم الاختيار المتعدّد، يمثّل هذا الحقل عنوان URL للرمز المعروض بجانب حقل text للعنصر. يمكن استخدام ملفات PNG وJPEG. يجب أن يكون عنوان URL لـ HTTPS. على سبيل المثال، https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png. في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد:
startIconUri

string

نهاية الحقول التي يستبعد كلّ منها الآخر