عنصر يمكن للمستخدمين اختياره في إدخال اختيار، مثل مربّع اختيار أو مفتاح تبديل. يمكن استخدام ما يصل إلى 100 عنصر.
تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.
| تمثيل JSON |
|---|
{ "text": string, "value": string, "selected": boolean, "bottomText": string, "startIconUri": string } |
| الحقول | |
|---|---|
text |
النص الذي يحدّد العنصر أو يصفه للمستخدمين. |
value |
القيمة المرتبطة بهذا العنصر يجب أن يستخدم العميل هذه القيمة كقيمة إدخال في النموذج. للحصول على تفاصيل حول العمل مع إدخالات النماذج، يُرجى الاطّلاع على تلقّي بيانات النماذج. |
selected |
ما إذا كان العنصر محدّدًا تلقائيًا إذا كان إدخال الاختيار يقبل قيمة واحدة فقط (مثل أزرار الاختيار أو القائمة المنسدلة)، اضبط هذا الحقل لعنصر واحد فقط. |
bottomText |
بالنسبة إلى القوائم المتعددة الاختيارات، يمثّل هذا الحقل وصفًا نصيًا أو تصنيفًا يتم عرضه أسفل حقل |
بالنسبة إلى قوائم الاختيار المتعدّد، يمثّل هذا الحقل عنوان URL للرمز المعروض بجانب حقل text للعنصر. يمكن استخدام ملفات PNG وJPEG. يجب أن يكون عنوان URL لـ HTTPS. على سبيل المثال، https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png. في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد: |
|
startIconUri |
|
| نهاية الحقول التي يستبعد كلّ منها الآخر | |