بطاقة
البطاقة هي عنصر في واجهة المستخدم يمكن أن يحتوي على أدوات واجهة المستخدم مثل النصوص والصور.
تمثيل JSON |
---|
{ "header": { object ( |
الحقول | |
---|---|
header
|
عنوان البطاقة عادةً ما يحتوي العنوان على عنوان وصورة. |
sections[]
|
يتم فصل الأقسام بمقسم خط. |
cardActions[]
|
إجراءات هذه البطاقة. |
name
|
اسم البطاقة |
CardHeader
تمثيل JSON |
---|
{
"title": string,
"subtitle": string,
"imageStyle": enum (
|
الحقول | |
---|---|
title
|
يجب تحديد العنوان. العنوان له ارتفاع ثابت: إذا تم تحديد كل من العنوان والعنوان الفرعي، فيتم تشغل كل منهما سطرًا واحدًا. إذا تم تحديد العنوان فقط، سيشغل كلا السطرين. |
subtitle
|
العنوان الفرعي لرأس البطاقة |
imageStyle
|
نوع الصورة (على سبيل المثال، حدود مربّعة أو حدود دائرية). |
imageUrl
|
عنوان URL للصورة في عنوان البطاقة |
ImageStyle
عمليات التعداد | |
---|---|
IMAGE_STYLE_UNSPECIFIED
|
|
IMAGE
|
حد مربّع |
AVATAR
|
حد دائري |
القسم
يحتوي القسم على مجموعة من الأدوات التي يتم عرضها (عموديًا) بالترتيب الذي تم تحديدها به. على جميع الأنظمة الأساسية، يكون عرض البطاقات ضيّقًا وثابتًا، لذلك ليست هناك حاجة حاليًا إلى خصائص التنسيق (على سبيل المثال، العدد العائم).
تمثيل JSON |
---|
{
"header": string,
"widgets": [
{
object (
|
الحقول | |
---|---|
header
|
تمثّل هذه السمة عنوان القسم. يمكن استخدام النص المنسَّق. لمزيد من المعلومات عن تنسيق النص، يمكنك الاطّلاع على تنسيق النص في تطبيقات Google Chat أو تنسيق النص في إضافات Google Workspace |
widgets[]
|
يجب أن يحتوي القسم على أداة واحدة على الأقل. |
WidgetMarkup
الأداة هي عنصر في واجهة المستخدم يعرض النصوص والصور.
تمثيل JSON |
---|
{ "buttons": [ { object ( |
الحقول | |
---|---|
buttons[]
|
قائمة بالأزرار تُعد الأزرار أيضًا
|
حقل الاتحاد
data حاسمة
WidgetMarkup
يمكن أن يحتوي على واحد فقط من العناصر التالية. يمكنك استخدام عدة طرق
WidgetMarkup
الحقول لعرض المزيد من العناصر.
data
واحد فقط مما يلي:
|
|
textParagraph
|
عرض فقرة نصية في هذا التطبيق المصغّر |
image
|
يمكنك عرض صورة في هذا التطبيق المصغّر. |
keyValue
|
عرض عنصر قيمة رئيسي في هذا التطبيق المصغّر |
TextParagraph
فقرة من النص. يمكن استخدام النص المنسَّق. لمزيد من المعلومات عن تنسيق النص، يمكنك الاطّلاع على تنسيق النص في تطبيقات Google Chat أو تنسيق النص في إضافات Google Workspace
تمثيل JSON |
---|
{ "text": string } |
الحقول | |
---|---|
text
|
|
صورة
صورة يتم تحديدها من خلال عنوان URL ويمكن أن تحتوي على
onclick
اتخاذ القرار.
تمثيل JSON |
---|
{
"imageUrl": string,
"onClick": {
object (
|
الحقول | |
---|---|
imageUrl
|
عنوان URL للصورة |
onClick
|
تشير رسالة الأشكال البيانية
|
aspectRatio
|
نسبة العرض إلى الارتفاع لهذه الصورة (العرض والارتفاع). يتيح لك هذا الحقل الاحتفاظ بالارتفاع المناسب للصورة أثناء انتظار تحميلها. وليس الغرض من ذلك تجاوز نسبة العرض إلى الارتفاع المدمجة للصورة. في حال ترك هذه السياسة بدون ضبط، يملأها الخادم عن طريق الجلب المُسبَق للصورة. |
OnClick
إنّ
onclick
إجراء (على سبيل المثال، فتح رابط).
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد
|
|
action
|
يتم تنفيذ إجراء في النموذج من خلال هذا الإجراء
|
openLink
|
هذا النمط
|
FormAction
يصف إجراء النموذج السلوك الذي يتم عند إرساله. على سبيل المثال، يمكنك استدعاء "برمجة تطبيقات Google" للتعامل مع النموذج.
تمثيل JSON |
---|
{
"actionMethodName": string,
"parameters": [
{
object (
|
الحقول | |
---|---|
actionMethodName
|
يتم استخدام اسم الطريقة لتحديد أي جزء من النموذج أدّى إلى إرسال النموذج. يتم تكرار هذه المعلومات في تطبيق Chat كجزء من حدث النقر على البطاقة. يمكنك استخدام اسم الطريقة نفسه لعدة عناصر تؤدي إلى سلوك شائع. |
parameters[]
|
قائمة مَعلمات الإجراء |
ActionParameter
قائمة بمعلَمات السلسلة التي سيتم تقديمها عند استدعاء طريقة الإجراء. على سبيل المثال، يمكنك التفكير في ثلاثة أزرار للتأجيل الآن، وتأجيل يوم واحد، وتأجيل من الأسبوع القادم. يمكنك استخدام
action method = snooze()
، مع تمرير نوع التأجيل ووقته في قائمة معلَمات السلسلة.
تمثيل JSON |
---|
{ "key": string, "value": string } |
الحقول | |
---|---|
key
|
اسم مَعلمة النص البرمجي للإجراء. |
value
|
قيمة المَعلمة |
OpenLink
رابط يفتح نافذة جديدة.
تمثيل JSON |
---|
{ "url": string } |
الحقول | |
---|---|
url
|
عنوان URL المطلوب فتحه. |
KeyValue
يحتوي عنصر في واجهة المستخدم على مفتاح (تصنيف) وقيمة (محتوى). يمكن أن يحتوي هذا العنصر أيضًا على بعض الإجراءات مثل
onclick
.
تمثيل JSON |
---|
{ "topLabel": string, "content": string, "contentMultiline": boolean, "bottomLabel": string, "onClick": { object ( |
الحقول | |
---|---|
topLabel
|
نص التصنيف العلوي. يمكن استخدام النص المنسَّق. لمزيد من المعلومات عن تنسيق النص، يمكنك الاطّلاع على تنسيق النص في تطبيقات Google Chat أو تنسيق النص في إضافات Google Workspace |
content
|
نص المحتوى. يكون النص المنسّق متوافقًا ومطلوبًا دائمًا. لمزيد من المعلومات عن تنسيق النص، يمكنك الاطّلاع على تنسيق النص في تطبيقات Google Chat أو تنسيق النص في إضافات Google Workspace |
contentMultiline
|
ما إذا كان يجب أن يكون المحتوى متعدد الأسطر. |
bottomLabel
|
نص التصنيف السفلي. يمكن استخدام النص المنسَّق. لمزيد من المعلومات عن تنسيق النص، يمكنك الاطّلاع على تنسيق النص في تطبيقات Google Chat أو تنسيق النص في إضافات Google Workspace |
onClick
|
تشير رسالة الأشكال البيانية
|
حقل الاتحاد
icons أحد الأيقونات على الأقل،
top_label
أو
bottom_label
.
icons
واحد فقط مما يلي:
|
|
icon
|
يشير ذلك المصطلح إلى قيمة تعداد يتم استبدالها في Chat API بصورة الرمز المقابلة. |
iconUrl
|
هو الرمز الذي يتم تحديده من خلال عنوان URL. |
حقل الاتحاد
control تطبيق عنصر التحكّم المصغّر. يمكنك تعيين إما
button
أو
switch_widget ، ولكن ليس الاثنين معًا.
control
واحد فقط مما يلي:
|
|
button
|
زرّ يمكن النقر عليه لتشغيل إجراء. |
الرمز
تمثّل هذه السمة مجموعة الرموز المتوافقة.
عمليات التعداد | |
---|---|
ICON_UNSPECIFIED
|
|
AIRPLANE
|
|
BOOKMARK
|
|
BUS
|
|
CAR
|
|
CLOCK
|
|
CONFIRMATION_NUMBER_ICON
|
|
DOLLAR
|
|
DESCRIPTION
|
|
EMAIL
|
|
EVENT_PERFORMER
|
|
EVENT_SEAT
|
|
FLIGHT_ARRIVAL
|
|
FLIGHT_DEPARTURE
|
|
HOTEL
|
|
HOTEL_ROOM_TYPE
|
|
INVITE
|
|
MAP_PIN
|
|
MEMBERSHIP
|
|
MULTIPLE_PEOPLE
|
|
OFFER
|
|
PERSON
|
|
PHONE
|
|
RESTAURANT_ICON
|
|
SHOPPING_CART
|
|
STAR
|
|
STORE
|
|
TICKET
|
|
TRAIN
|
|
VIDEO_CAMERA
|
|
VIDEO_PLAY
|
زرّ
زر يمكن أن يكون زرًا نصيًا أو زر صورة.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد
|
|
textButton
|
زر يحتوي على نص
|
imageButton
|
زر مع صورة
|
TextButton
زر يحتوي على نص
onclick
اتخاذ القرار.
تمثيل JSON |
---|
{
"text": string,
"onClick": {
object (
|
الحقول | |
---|---|
text
|
النص المكتوب على الزر. |
onClick
|
تشير رسالة الأشكال البيانية
|
ImageButton
زر صورة مع
onclick
اتخاذ القرار.
تمثيل JSON |
---|
{ "onClick": { object ( |
الحقول | |
---|---|
onClick
|
تشير رسالة الأشكال البيانية
|
name
|
اسم هذا
|
حقل الاتحاد
icons يمكن تحديد الرمز من خلال
Icon
enum
أو عنوان URL.
icons
واحد فقط مما يلي:
|
|
icon
|
يشير هذا المصطلح إلى الرمز الذي يتم تحديده من خلال
|
iconUrl
|
هو الرمز الذي يتم تحديده من خلال عنوان URL. |
CardAction
الإجراء المرتبط بالبطاقة هو الإجراء المرتبط بالبطاقة. بالنسبة إلى بطاقة فواتير، يكون الإجراء النموذجي هو: حذف الفاتورة، أو البريد الإلكتروني، أو فتح الفاتورة في المتصفح.
غير متاح في تطبيقات Google Chat.
تمثيل JSON |
---|
{
"actionLabel": string,
"onClick": {
object (
|
الحقول | |
---|---|
actionLabel
|
التصنيف الذي كان معروضًا في عنصر قائمة الإجراءات |
onClick
|
إجراء JSON لبند العمل هذا. |