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

  // 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)

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