Cards v1

بطاقة

البطاقة هي عنصر في واجهة المستخدم يمكن أن يحتوي على تطبيقات مصغّرة لواجهة المستخدم، مثل النصوص والصور.

تمثيل JSON 
{
  "header": {
    object (CardHeader)
  },
  "sections": [
    {
      object (Section)
    }
  ],
  "cardActions": [
    {
      object (CardAction)
    }
  ],
  "name": string
}
الحقول
header

object (CardHeader)

رأس البطاقة يحتوي العنوان عادةً على عنوان وصورة.

sections[]

object (Section)

يتم الفصل بين الأقسام باستخدام خط فاصل.

cardActions[]

object (CardAction)

الإجراءات المتعلّقة بهذه البطاقة

name

string

اسم البطاقة

CardHeader

تمثيل JSON 
{
  "title": string,
  "subtitle": string,
  "imageStyle": enum (ImageStyle),
  "imageUrl": string
}
الحقول
title

string

يجب تحديد العنوان. يتميّز العنوان بارتفاع ثابت: إذا تم تحديد عنوان وعنوان فرعي، يشغل كل منهما سطرًا واحدًا. إذا تم تحديد العنوان فقط، فسيشغل كلا السطرين.

subtitle

string

العنوان الفرعي لرأس البطاقة

imageStyle

enum (ImageStyle)

نوع الصورة (على سبيل المثال، حدود مربّعة أو حدود دائرية)

imageUrl

string

عنوان URL للصورة في رأس البطاقة

ImageStyle

عمليات التعداد
IMAGE_STYLE_UNSPECIFIED
IMAGE حدود مربّعة
AVATAR حدود دائرية

القسم

يحتوي القسم على مجموعة من التطبيقات المصغّرة التي يتم عرضها (عموديًا) بالترتيب المحدّد لها. على جميع المنصات، يكون للبطاقات عرض ثابت ضيق، لذلك ليست هناك حاجة حاليًا لسمات التنسيق (على سبيل المثال، float).

تمثيل JSON 
{
  "header": string,
  "widgets": [
    {
      object (WidgetMarkup)
    }
  ]
}
الحقول
header

string

تمثّل هذه السمة عنوان القسم. يمكن استخدام النص المنسَّق. لمزيد من المعلومات حول تنسيق النص، يُرجى الاطّلاع على تنسيق النص في تطبيقات Google Chat و تنسيق النص في إضافات Google Workspace.

widgets[]

object (WidgetMarkup)

يجب أن يحتوي القسم على تطبيق مصغّر واحد على الأقل.

WidgetMarkup

الأداة هي عنصر في واجهة المستخدم يعرض النصوص والصور.

تمثيل JSON 
{
  "buttons": [
    {
      object (Button)
    }
  ],

  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "keyValue": {
    object (KeyValue)
  }
}
الحقول
buttons[]

object (Button)

قائمة بالأزرار الأزرار هي أيضًا oneof data ويجب تعيين حقل واحد فقط من هذه الحقول.

يمكن أن يحتوي WidgetMarkup واحد فقط على أحد العناصر التالية. ويمكنك استخدام عدّة حقول WidgetMarkup لعرض المزيد من العناصر. في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد:
textParagraph

object (TextParagraph)

لعرض فقرة نصية في هذا التطبيق المصغّر

image

object (Image)

عرض صورة في هذه الأداة

keyValue

object (KeyValue)

عرض عنصر قيمة مفتاح في هذه الأداة

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

TextParagraph

فقرة نصية يمكن استخدام نص منسَّق. لمزيد من المعلومات حول تنسيق النص، يُرجى الاطّلاع على تنسيق النص في تطبيقات Google Chat و تنسيق النص في إضافات Google Workspace.

تمثيل JSON 
{
  "text": string
}
الحقول
text

string

صورة

صورة يتم تحديدها من خلال عنوان URL ويمكن أن تتضمّن إجراءً onclick .

تمثيل JSON 
{
  "imageUrl": string,
  "onClick": {
    object (OnClick)
  },
  "aspectRatio": number
}
الحقول
imageUrl

string

عنوان URL للصورة

onClick

object (OnClick)

الإجراء onclick .

aspectRatio

number

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

OnClick

إجراء onclick (على سبيل المثال، فتح رابط)

تمثيل JSON 
{

  "action": {
    object (FormAction)
  },
  "openLink": {
    object (OpenLink)
  }
}
الحقول
في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد:
action

object (FormAction)

يتم تفعيل إجراء نموذج من خلال إجراء onclick هذا في حال تحديده.

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

FormAction

يصف إجراء النموذج السلوك عند إرسال النموذج. على سبيل المثال، يمكنك استدعاء "برمجة تطبيقات Google" لمعالجة النموذج.

تمثيل JSON 
{
  "actionMethodName": string,
  "parameters": [
    {
      object (ActionParameter)
    }
  ]
}
الحقول
actionMethodName

string

يُستخدَم اسم الطريقة لتحديد الجزء الذي أدّى إلى إرسال النموذج. يتم إرسال هذه المعلومات مرة أخرى إلى تطبيق Chat كجزء من حدث ناتج عن النقر على البطاقة. يمكنك استخدام اسم الطريقة نفسه لعدة عناصر تؤدي إلى سلوك شائع.

parameters[]

object (ActionParameter)

قائمة بمَعلمات الإجراءات

ActionParameter

قائمة بمَعلمات السلسلة التي يجب توفيرها عند استدعاء طريقة الإجراء على سبيل المثال، ضع في اعتبارك ثلاثة أزرار تأجيل: التأجيل الآن، والتأجيل ليوم واحد، والتأجيل للأسبوع المقبل. يمكنك استخدام action method = snooze()، مع تمرير نوع التأجيل ووقت التأجيل في قائمة مَعلمات السلسلة.

تمثيل JSON 
{
  "key": string,
  "value": string
}
الحقول
key

string

اسم مَعلمة نص الإجراء البرمجي

value

string

قيمة المَعلمة

KeyValue

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

تمثيل JSON 
{
  "topLabel": string,
  "content": string,
  "contentMultiline": boolean,
  "bottomLabel": string,
  "onClick": {
    object (OnClick)
  },

  "icon": enum (Icon),
  "iconUrl": string

  "button": {
    object (Button)
  }
}
الحقول
topLabel

string

نص التصنيف العلوي يمكن استخدام نص منسَّق. لمزيد من المعلومات حول تنسيق النص، يُرجى الاطّلاع على تنسيق النص في تطبيقات Google Chat و تنسيق النص في إضافات Google Workspace.

content

string

نص المحتوى يجب دائمًا إدخال نص منسَّق. لمزيد من المعلومات حول تنسيق النص، يُرجى الاطّلاع على تنسيق النص في تطبيقات Google Chat و تنسيق النص في إضافات Google Workspace.

contentMultiline

boolean

ما إذا كان يجب أن يكون المحتوى متعدد الأسطر

bottomLabel

string

نص التصنيف السفلي يمكن استخدام نص منسَّق. لمزيد من المعلومات حول تنسيق النص، يُرجى الاطّلاع على تنسيق النص في تطبيقات Google Chat و تنسيق النص في إضافات Google Workspace.

onClick

object (OnClick)

الإجراء onclick . يمكن النقر فقط على التصنيف العلوي والتصنيف السفلي ومنطقة المحتوى.

يجب تحديد سمة واحدة على الأقل من سمات الرموز، top_label و bottom_label. في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد:
icon

enum (Icon)

قيمة تعداد تستبدلها Chat API بصورة الرمز المقابلة.

iconUrl

string

الرمز المحدّد بواسطة عنوان URL

نهاية الحقول التي يستبعد كلّ منها الآخر
عنصر تحكّم في التطبيقات المصغّرة يمكنك ضبط button أو switch_widget، ولكن ليس كليهما. في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد:
button

object (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

زرّ

الزر A يمكن أن يكون زرًا نصيًا أو زر صورة.

تمثيل JSON 
{

  "textButton": {
    object (TextButton)
  },
  "imageButton": {
    object (ImageButton)
  }
}
الحقول
في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد:
textButton

object (TextButton)

زرّ يتضمّن نصًا وإجراء onclick.

imageButton

object (ImageButton)

زر يتضمّن صورة وإجراء onclick .

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

TextButton

زر يتضمّن نصًا وإجراء onclick .

تمثيل JSON 
{
  "text": string,
  "onClick": {
    object (OnClick)
  }
}
الحقول
text

string

النص المكتوب على الزر.

onClick

object (OnClick)

الإجراء onclick الخاص بالزر

ImageButton

زر صورة يتضمّن الإجراء onclick.

تمثيل JSON 
{
  "onClick": {
    object (OnClick)
  },
  "name": string,

  "icon": enum (Icon),
  "iconUrl": string
}
الحقول
onClick

object (OnClick)

الإجراء onclick .

name

string

اسم imageButton هذا المستخدَم لتسهيل الاستخدام. يتم توفير القيمة التلقائية في حال عدم تحديد هذا الاسم.

يمكن تحديد الرمز من خلال Icon enum أو عنوان URL. في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد:
icon

enum (Icon)

الرمز الذي يحدّده enum والذي يشير إلى رمز توفّره Chat API.

iconUrl

string

الرمز المحدّد بواسطة عنوان URL

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

CardAction

إجراء البطاقة هو الإجراء المرتبط بالبطاقة. بالنسبة إلى بطاقة الفاتورة، يكون الإجراء المعتاد هو: حذف الفاتورة أو إرسال الفاتورة عبر البريد الإلكتروني أو فتح الفاتورة في المتصفّح.

لا تتيح تطبيقات Google Chat هذه الميزة.

تمثيل JSON 
{
  "actionLabel": string,
  "onClick": {
    object (OnClick)
  }
}
الحقول
actionLabel

string

التصنيف الذي كان يُعرض في عنصر قائمة الإجراءات

onClick

object (OnClick)

الإجراء الذي يتم تنفيذه عند النقر على بند العمل هذا