Cards v1

{
  "header": {
    object (CardHeader)
  },
  "sections": [
    {
      object (Section)
    }
  ],
  "cardActions": [
    {
      object (CardAction)
    }
  ],
  "name": string
}

object (CardHeader)

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

object (Section)

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

object (CardAction)

إجراءات هذه البطاقة.

string

اسم البطاقة

{
  "title": string,
  "subtitle": string,
  "imageStyle": enum (ImageStyle),
  "imageUrl": string
}

string

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

string

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

enum (ImageStyle)

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

string

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

{
  "header": string,
  "widgets": [
    {
      object (WidgetMarkup)
    }
  ]
}

string

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

object (WidgetMarkup)

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

{
  "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.
}

object (Button)

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

object (TextParagraph)

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

object (Image)

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

object (KeyValue)

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

{
  "text": string
}

string

{
  "imageUrl": string,
  "onClick": {
    object (OnClick)
  },
  "aspectRatio": number
}

string

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

object (OnClick)

الإجراء onclick.

number

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

{

  // 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.
}

object (FormAction)

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

object (OpenLink)

يؤدّي هذا الإجراء onclick إلى تفعيل إجراء رابط مفتوح إذا تم تحديده.

{
  "actionMethodName": string,
  "parameters": [
    {
      object (ActionParameter)
    }
  ]
}

string

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

object (ActionParameter)

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

{
  "key": string,
  "value": string
}

string

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

string

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

{
  "url": string
}

string

عنوان URL المطلوب فتحه.

{
  "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.
}

string

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

string

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

boolean

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

string

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

object (OnClick)

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

enum (Icon)

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

string

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

object (Button)

زر يمكن النقر عليه لتشغيل إجراء معيّن.

{

  // 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.
}

object (TextButton)

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

object (ImageButton)

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

{
  "text": string,
  "onClick": {
    object (OnClick)
  }
}

string

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

object (OnClick)

تمثّل هذه الخاصية الإجراء onclick للزر.

{
  "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.
}

object (OnClick)

الإجراء onclick.

string

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

enum (Icon)

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

string

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

{
  "actionLabel": string,
  "onClick": {
    object (OnClick)
  }
}

string

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

object (OnClick)

إجراء النقر على عنصر العمل هذا.