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 حد دائري

القسم

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

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

string

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

widgets[]

object (WidgetMarkup)

يجب أن يحتوي القسم على أداة واحدة على الأقل.

WidgetMarkup

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

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

  // Union field data can be only one of the following:
  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "keyValue": {
    object (KeyValue)
  }
  // End of list of possible types for union field data.
}
الحقول
buttons[]

object (Button)

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

حقل الاتحاد data حاسمة WidgetMarkup يمكن أن يحتوي على واحد فقط من العناصر التالية. يمكنك استخدام عدة طرق WidgetMarkup الحقول لعرض المزيد من العناصر. data واحد فقط مما يلي:
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
{

  // Union field data can be only one of the following:
  "action": {
    object (FormAction)
  },
  "openLink": {
    object (OpenLink)
  }
  // End of list of possible types for union field data.
}
الحقول

حقل الاتحاد data

data واحد فقط مما يلي:

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)
  },

  // Union field icons can be only one of the following:
  "icon": enum (Icon),
  "iconUrl": string
  // End of list of possible types for union field icons.

  // Union field control can be only one of the following:
  "button": {
    object (Button)
  }
  // End of list of possible types for union field control.
}
الحقول
topLabel

string

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

content

string

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

contentMultiline

boolean

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

bottomLabel

string

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

onClick

object (OnClick)

تشير رسالة الأشكال البيانية onclick اتخاذ القرار. لا يمكن النقر إلا على التصنيف العلوي والتصنيف السفلي ومنطقة المحتوى.

حقل الاتحاد icons أحد الأيقونات على الأقل، top_label أو bottom_label . icons واحد فقط مما يلي:
icon

enum (Icon)

يشير ذلك المصطلح إلى قيمة تعداد يتم استبدالها في Chat API بصورة الرمز المقابلة.

iconUrl

string

هو الرمز الذي يتم تحديده من خلال عنوان URL.

حقل الاتحاد control تطبيق عنصر التحكّم المصغّر. يمكنك تعيين إما button أو switch_widget، ولكن ليس الاثنين معًا. control واحد فقط مما يلي:
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

زرّ

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

تمثيل JSON
{

  // Union field type can be only one of the following:
  "textButton": {
    object (TextButton)
  },
  "imageButton": {
    object (ImageButton)
  }
  // End of list of possible types for union field type.
}
الحقول

حقل الاتحاد type

type واحد فقط مما يلي:

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,

  // Union field icons can be only one of the following:
  "icon": enum (Icon),
  "iconUrl": string
  // End of list of possible types for union field icons.
}
الحقول
onClick

object (OnClick)

تشير رسالة الأشكال البيانية onclick اتخاذ القرار.

name

string

اسم هذا imageButton يُستخدم لإمكانية الوصول. يتم توفير القيمة التلقائية في حال عدم تحديد هذا الاسم.

حقل الاتحاد icons يمكن تحديد الرمز من خلال Icon enum أو عنوان URL. icons واحد فقط مما يلي:
icon

enum (Icon)

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

iconUrl

string

هو الرمز الذي يتم تحديده من خلال عنوان URL.

CardAction

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

غير متاح في تطبيقات Google Chat.

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

string

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

onClick

object (OnClick)

إجراء JSON لبند العمل هذا.