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

اسم البطاقة

عنوان البطاقة

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

string

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

subtitle

string

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

imageStyle

enum ( ImageStyle )

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

imageUrl

string

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

نمط الصورة

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

القسم

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

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

string

عنوان القسم، النص منسَّق.

widgets[]

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

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

حقل الاتحاد data . يمكن أن يحتوي WidgetMarkup على عنصر واحد فقط من العناصر التالية. ويمكنك استخدام حقول WidgetMarkup متعددة لعرض المزيد من العناصر. data يمكن أن تكون واحدة مما يلي:
textParagraph

object ( TextParagraph )

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

image

object ( Image )

يمكنك عرض صورة في هذه الأداة.

keyValue

object ( KeyValue )

عرض عنصر رئيسي القيمة في هذه الأداة.

فقرة نصية

فقرة نصية. تم تنسيق النص المنسَّق.

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

string

صورة

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

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

string

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

onClick

object ( OnClick )

إجراء onclick.

aspectRatio

number

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

OnOn

إجراء 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 onclick هذا إذا كان محددًا.

إجراء النموذج

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

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

string

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

parameters[]

object ( ActionParameter )

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

معلَمة الإجراء

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

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

string

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

value

string

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

القيمة الأساسية

يحتوي عنصر واجهة المستخدم على مفتاح (تصنيف) وقيمة (محتوى). وقد يحتوي هذا العنصر أيضًا على بعض الإجراءات، مثل زر 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.
  "button": {
    object (Button)
  }
}
الحقول
topLabel

string

نص التصنيف العلوي. تم تنسيق النص المنسَّق.

content

string

تمثّل هذه السمة نص المحتوى. النص المنسَّق متاح ومطلوب دائمًا.

contentMultiline

boolean

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

bottomLabel

string

نص التصنيف السفلي. تم تنسيق النص المنسَّق.

onClick

object ( OnClick )

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

حقل الاتحاد icons . يجب تحديد رمز واحد على الأقل، وtop_label وlabel_label. icons يمكن أن تكون واحدة مما يلي:
icon

enum ( Icon )

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

iconUrl

string

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

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 )

زر يحتوي على صورة وإجراء TalkBack.

زر نصي

زر يحتوي على إجراء نصي و onclick.

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

string

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

onClick

object ( OnClick )

إجراء onclick للزر.

زر الصورة

زر صورة مع إجراء 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

اسم هذه الصورة المصوّرة التي سيتم استخدامها لتسهيل الاستخدام. سيتم توفير القيمة التلقائية في حال عدم تحديد مطوّري البرامج.

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

enum ( Icon )

الرمز المحدَّد من خلال تعداد يوضّح إلى رمز توفّره واجهة برمجة التطبيقات Chat.

iconUrl

string

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

إجراء بشأن البطاقة

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

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

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

string

التصنيف المستخدم للعرض في عنصر قائمة الإجراءات.

onClick

object ( OnClick )

إجراء onclick لعنصر العمل هذا