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)

قائمة بالأزرار يجب أيضًا ضبط حقل Buttons على 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

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

تمثيل 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 لبند العمل هذا.