تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Package google.apps.card.v1

الفهرس

Action (رسالة)
Action.ActionParameter (رسالة)
Action.Interaction (تعداد)
Action.LoadIndicator (تعداد)
BorderStyle (رسالة)
BorderStyle.BorderType (تعداد)
Button (رسالة)
Button.Type (تعداد)
ButtonList (رسالة)
Card (رسالة)
Card.CardAction (رسالة)
Card.CardFixedFooter (رسالة)
Card.CardHeader (رسالة)
Card.DisplayStyle (تعداد)
Card.DividerStyle (تعداد)
Card.Section (رسالة)
Chip (رسالة)
ChipList (رسالة)
ChipList.Layout (تعداد)
CollapseControl (رسالة)
Columns (رسالة)
Columns.Column (رسالة)
Columns.Column.HorizontalSizeStyle (تعداد)
Columns.Column.VerticalAlignment (تعداد)
Columns.Column.Widgets (رسالة)
DateTimePicker (رسالة)
DateTimePicker.DateTimePickerType (تعداد)
DecoratedText (رسالة)
DecoratedText.SwitchControl (رسالة)
DecoratedText.SwitchControl.ControlType (تعداد)
Divider (رسالة)
EndNavigation (رسالة)
EndNavigation.Action (تعداد)
GetAutocompletionResponse (رسالة)
Grid (رسالة)
Grid.GridItem (رسالة)
Grid.GridItem.GridItemLayout (تعداد)
Icon (رسالة)
Image (رسالة)
ImageComponent (رسالة)
ImageCropStyle (رسالة)
ImageCropStyle.ImageCropType (تعداد)
Link (رسالة)
LinkPreview (رسالة)
MaterialIcon (رسالة)
Navigation (رسالة)
Notification (رسالة)
OnClick (رسالة)
OpenLink (رسالة)
OpenLink.OnClose (تعداد)
OpenLink.OpenAs (تعداد)
OverflowMenu (رسالة)
OverflowMenu.OverflowMenuItem (رسالة)
RenderActions (رسالة)
RenderActions.Action (رسالة)
SelectionInput (رسالة)
SelectionInput.PlatformDataSource (رسالة)
SelectionInput.PlatformDataSource.CommonDataSource (تعداد)
SelectionInput.SelectionItem (رسالة)
SelectionInput.SelectionType (تعداد)
SubmitFormResponse (رسالة)
Suggestions (رسالة)
Suggestions.SuggestionItem (رسالة)
TextInput (رسالة)
TextInput.Type (تعداد)
TextParagraph (رسالة)
Validation (رسالة)
Validation.InputType (تعداد)
Widget (رسالة)
Widget.HorizontalAlignment (تعداد)
Widget.ImageType (تعداد)

الإجراء

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

متاحة لتطبيقات Google Chat وإضافات Google Workspace.

الحقول
`function`	`string` دالة مخصّصة للتنفيذ عند النقر على العنصر الذي يحتوي على العنصر المعنيّ أو تفعيله بأي طريقة أخرى للاطّلاع على أمثلة على الاستخدام، راجِع قراءة بيانات النموذج.
`parameters[]`	`ActionParameter` قائمة بمَعلمات الإجراءات
`loadIndicator`	`LoadIndicator` تحدِّد هذه السياسة مؤشر التحميل الذي يعرضه الإجراء أثناء تطبيق عبارة الحث على اتّخاذ إجراء.
`persistValues`	`bool` تشير إلى ما إذا كانت قيم النموذج تظل محفوظة بعد الإجراء. تكون القيمة التلقائية `false`. إذا كانت القيمة `true`، تظلّ قيم النموذج محفوظة بعد بدء الإجراء. للسماح للمستخدم بإجراء تغييرات أثناء معالجة الإجراء، اضبط `LoadIndicator` على `NONE`. بالنسبة إلى رسائل البطاقات في تطبيقات Chat، عليك أيضًا ضبط `ResponseType` الإجراء على `UPDATE_MESSAGE` واستخدام `card_id` نفسه من البطاقة التي تحتوي على الإجراء. إذا كانت القيمة `false`، يتم محو قيم النموذج عند بدء الإجراء. لمنع المستخدم من إجراء تغييرات أثناء معالجة الإجراء، اضبط السمة `LoadIndicator` على `SPINNER`.
`interaction`	`Interaction` اختياريّ. مطلوب عند فتح مربّع حوار. الإجراءات التي يجب اتّخاذها استجابةً للتفاعل مع مستخدم، مثل النقر على زر في رسالة البطاقة وفي حال عدم تحديد ذلك، يستجيب التطبيق من خلال تنفيذ `action`، مثل فتح رابط أو تشغيل وظيفة، كالمعتاد. من خلال تحديد `interaction`، يمكن للتطبيق الرد بطرق تفاعلية خاصة. على سبيل المثال، من خلال ضبط `interaction` على `OPEN_DIALOG`، يمكن للتطبيق فتح مربّع حوار. ولا يظهر مؤشر تحميل عند تحديده. إذا تم تحديدها لإضافة، تتم إزالة البطاقة بالكامل ولا يظهر أي شيء في البرنامج. متاحة لتطبيقات Google Chat وغير متاحة لإضافات Google Workspace.
`requiredWidgets[]`	`string` إصدار المطوّر: يتوفّر كجزء من برنامج إصدار المطوّر في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة. اختياريّ. املأ هذه القائمة بأسماء التطبيقات المصغّرة التي يحتاجها هذا الإجراء لإرسال صالح. إذا لم تكن التطبيقات المصغّرة المدرَجة هنا تحتوي على قيمة عند استدعاء هذا الإجراء، سيتم إلغاء عملية إرسال النموذج. تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.
`allWidgetsAreRequired`	`bool` إصدار المطوّر: يتوفّر كجزء من برنامج إصدار المطوّر في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة. اختياريّ. إذا كان هذا صحيحًا، فستُعتبر جميع التطبيقات المصغّرة مطلوبة بموجب هذا الإجراء. متاحة لتطبيقات Google Chat وإضافات Google Workspace.

ActionParameter

قائمة بمَعلمات السلاسل التي يجب تقديمها عند استدعاء طريقة الإجراء على سبيل المثال، يمكنك التفكير في ثلاثة أزرار للتأجيل الآن أو الإزالة مؤقتًا لمدة يوم واحد أو التأجيل من الأسبوع المقبل. يمكنك استخدام action method = snooze()، مع تمرير نوع الغفوة ووقت الغفوة في قائمة مَعلمات السلاسل.

لمزيد من المعلومات، يُرجى الاطّلاع على CommonEventObject.

متاحة لتطبيقات Google Chat وإضافات Google Workspace.

الحقول

الحقول
`key`	`string` اسم المَعلمة لنص الإجراء
`value`	`string` قيمة المَعلمة

key

string

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

value

string

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

التفاعل

اختياريّ. مطلوب عند فتح مربع حوار.

الإجراءات التي يجب اتّخاذها استجابةً للتفاعل مع مستخدم، مثل النقر على زر في رسالة البطاقة

وفي حال عدم تحديد ذلك، يستجيب التطبيق من خلال تنفيذ action، مثل فتح رابط أو تشغيل وظيفة، كالمعتاد.

من خلال تحديد interaction، يمكن للتطبيق الرد بطرق تفاعلية خاصة. على سبيل المثال، من خلال ضبط interaction على OPEN_DIALOG، يمكن للتطبيق فتح مربّع حوار.

عند تحديد هذه السمة، لا يظهر مؤشر التحميل. إذا تم تحديدها لإضافة، تتم إزالة البطاقة بالكامل ولا يظهر أي شيء في البرنامج.

متاحة لتطبيقات Google Chat وغير متاحة لإضافات Google Workspace.

عمليات التعداد

INTERACTION_UNSPECIFIED القيمة التلقائية. يتم تنفيذ action كالمعتاد.

عمليات التعداد
`INTERACTION_UNSPECIFIED`	القيمة التلقائية. يتم تنفيذ `action` كالمعتاد.
`OPEN_DIALOG`	يتم فتح مربع حوار، وهو واجهة تتضمّن بطاقة في النافذة تستخدمها تطبيقات Chat للتفاعل مع المستخدمين. لا يتوفّر هذا الخيار إلا في تطبيقات Chat استجابةً للنقر على الأزرار في رسائل البطاقات. إذا تم تحديدها لإضافة، تتم إزالة البطاقة بالكامل ولا يظهر أي شيء في البرنامج. تتوفّر هذه الميزة لتطبيقات Google Chat ولا تتوفّر لإضافات Google Workspace.

OPEN_DIALOG

يتم فتح مربع حوار، وهو واجهة تتضمّن بطاقة في النافذة تستخدمها تطبيقات Chat للتفاعل مع المستخدمين.

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

تتوفّر هذه الميزة لتطبيقات Google Chat ولا تتوفّر لإضافات Google Workspace.

LoadIndicator

تحدِّد هذه السياسة مؤشر التحميل الذي يعرضه الإجراء أثناء تطبيق عبارة الحث على اتّخاذ إجراء.

متاحة لتطبيقات Google Chat وإضافات Google Workspace.

عمليات التعداد
`SPINNER`	تعرِض هذه العلامة عنصر تحميل دوّارًا للإشارة إلى أنّه يتم تحميل المحتوى.
`NONE`	لا يتم عرض أي بيانات.

BorderStyle

خيارات النمط لحدود البطاقة أو التطبيق المصغّر، بما في ذلك نوع الحدود ولونها.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

الحقول

الحقول
`type`	`BorderType` نوع الحد.
`strokeColor`	`Color` الألوان التي يتم استخدامها عندما يكون النوع `BORDER_TYPE_STROKE`. لضبط لون الخطوط، حدِّد قيمة لحقول `red` و`green` و`blue`. يجب أن تكون القيمة عددًا عشريًا بين 0 و1 استنادًا إلى قيمة لون RGB، حيث يمثّل `0` (0/255) عدم توفّر اللون ويمثّل `1` (255/255) الحد الأقصى لكثافة اللون. على سبيل المثال، يؤدي ما يلي إلى ضبط اللون على اللون الأحمر عند أقصى كثافة له: `"color": { "red": 1, "green": 0, "blue": 0, }` الحقل `alpha` غير متاح للون الخط. يتم تجاهل هذا الحقل في حال تحديده.
`cornerRadius`	`int32` نصف قطر الزاوية للحدود

type

BorderType

نوع الحد.

strokeColor

Color

الألوان التي يتم استخدامها عندما يكون النوع BORDER_TYPE_STROKE.

لضبط لون الخطوط، حدِّد قيمة لحقول red وgreen وblue. يجب أن تكون القيمة عددًا عشريًا بين 0 و1 استنادًا إلى قيمة لون RGB، حيث يمثّل 0 (0/255) عدم توفّر اللون ويمثّل 1 (255/255) الحد الأقصى لكثافة اللون.

على سبيل المثال، يؤدي ما يلي إلى ضبط اللون على اللون الأحمر عند أقصى كثافة له:

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
}

الحقل alpha غير متاح للون الخط. يتم تجاهل هذا الحقل في حال تحديده.

cornerRadius

int32

نصف قطر الزاوية للحدود

BorderType

تمثل هذه السمة أنواع الحدود المطبَّقة على التطبيقات المصغّرة.

متاحة لتطبيقات Google Chat وإضافات Google Workspace.

عمليات التعداد
`BORDER_TYPE_UNSPECIFIED`	لا تستخدِم هذه الميزة. غير محدد
`NO_BORDER`	القيمة التلقائية. بدون حدود
`STROKE`	مخطط تفصيلي.

زرّ

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

لجعل صورة زرًا قابلاً للنقر، حدِّد Image (وليس ImageComponent) واضبط الإجراء onClick.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

الحقول
`text`	`string` النص المعروض داخل الزر.
`icon`	`Icon` رمز معروض داخل الزر إذا تم ضبط `icon` و`text`، سيظهر الرمز قبل النص.
`color`	`Color` اختياريّ. لون الزر في حال ضبط الزرّ `type` على `FILLED`، وتم ضبط لون حقلَي `text` و`icon` على لون متباين لسهولة القراءة. على سبيل المثال، إذا تم تعيين لون الزر على اللون الأزرق، فسيتم تعيين أي نص أو رموز في الزر على اللون الأبيض. لضبط لون الزر، حدِّد قيمة لحقول `red` و`green` و`blue`. يجب أن تكون القيمة عددًا عشريًا بين 0 و1 استنادًا إلى قيمة لون RGB، حيث يمثّل `0` (0/255) عدم توفّر اللون ويمثّل `1` (255/255) الحد الأقصى لكثافة اللون. على سبيل المثال، يؤدي ما يلي إلى ضبط اللون على اللون الأحمر عند أقصى كثافة له: `"color": { "red": 1, "green": 0, "blue": 0, }` لا يتوفّر الحقل `alpha` للون الزر. وفي حال تحديد هذا الحقل، سيتم تجاهل هذا الحقل.
`onClick`	`OnClick` مطلوب. إجراء يتم تنفيذه عندما ينقر المستخدم على الزر، مثل فتح رابط تشعبي أو تشغيل دالة مخصصة.
`disabled`	`bool` إذا كان `true`، يظهر الزر في حالة غير نشط ولا يستجيب لإجراءات المستخدم.
`altText`	`string` تمثّل هذه السمة النص البديل المستخدم في تسهيل الاستخدام. اضبط نصًا وصفيًا يُعلِم المستخدمين بوظائف الزر. على سبيل المثال، إذا كان أحد الأزرار يفتح رابطًا تشعّبيًا، يمكنك كتابة: "يفتح علامة تبويب جديدة في المتصفّح وينتقل إلى مستندات مطوّري برامج Google Chat على الرابط https://developers.google.com/workspace/chat".
`type`	`Type` اختياريّ. نوع الزر. وفي حال ترك هذه السياسة بدون ضبط، سيتم ضبط نوع الزر تلقائيًا على "`OUTLINED`". وفي حال ضبط الحقل `color`، يتم فرض نوع الزر على `FILLED` ويتم تجاهل أي قيمة تم ضبطها لهذا الحقل. تتوفّر هذه الميزة لتطبيقات Google Chat ولا تتوفّر لإضافات Google Workspace.

النوع

اختياريّ. نوع الزر في حال ضبط الحقل color، يتم ضبط الحقل type على FILLED.

متاحة لتطبيقات Google Chat وغير متاحة لإضافات Google Workspace.

عمليات التعداد
`TYPE_UNSPECIFIED`	يُرجى عدم استخدامها. غير محدد
`OUTLINED`	الأزرار المخططة هي أزرار متوسطة التوكيد. عادةً ما تحتوي على إجراءات مهمة، ولكنها ليست الإجراء الأساسي في تطبيق Chat أو إضافة.
`FILLED`	يحتوي الزر المعبأ على حاوية بلون خالص. ويُعدّ هذا اللون الأكثر تأثيرًا من الناحية المرئية، ويُنصح به للإجراءات المهمة والأساسية في تطبيق Chat أو إحدى الإضافات.
`FILLED_TONAL`	يُعدّ الزرّ المعبأ بالألوان المتجانسة خيارًا وسطًا بديلاً بين الأزرار المعبأة والمخطّطة. وهي مفيدة في السياقات التي يتطلب فيها زر الأولوية الأقل توكيدًا أكثر قليلاً مما قد يعطيه زر المخطط التفصيلي.
`BORDERLESS`	لا يحتوي الزر على حاوية غير مرئية في حالته التلقائية. ويتم استخدامه غالبًا للإجراءات ذات الأولوية الأدنى، خاصةً عند عرض خيارات متعدّدة.

ButtonList

قائمة بالأزرار الموضوعة أفقيًا. للاطّلاع على مثال في تطبيقات Google Chat، انتقِل إلى قسم إضافة زر.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

الحقول

الحقول
`buttons[]`	`Button` مصفوفة من الأزرار.

buttons[]

Button

مصفوفة من الأزرار.

بطاقة

واجهة بطاقة معروضة في رسالة على Google Chat أو إضافة Google Workspace

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

تصميم البطاقات ومعاينتها باستخدام "أداة إنشاء البطاقات"

فتح "أداة إنشاء البطاقات"

لمعرفة كيفية إنشاء البطاقات، يُرجى الاطّلاع على المستندات التالية:

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

مثال: رسالة بطاقة لتطبيق Google Chat

مثال على بطاقة جهة اتصال

لإنشاء نموذج لرسالة البطاقة في Google Chat، استخدِم ملف JSON التالي:

{
  "cardsV2": [
    {
      "cardId": "unique-card-id",
      "card": {
        "header": {
           "title": "Sasha",
           "subtitle": "Software Engineer",
           "imageUrl":
           "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
           "imageType": "CIRCLE",
           "imageAltText": "Avatar for Sasha"
         },
         "sections": [
           {
             "header": "Contact Info",
             "collapsible": true,
             "uncollapsibleWidgetsCount": 1,
             "widgets": [
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "EMAIL"
                   },
                   "text": "[email protected]"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PERSON"
                   },
                   "text": "<font color=\"#80e27e\">Online</font>"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PHONE"
                   },
                   "text": "+1 (555) 555-1234"
                 }
               },
               {
                 "buttonList": {
                   "buttons": [
                     {
                       "text": "Share",
                       "onClick": {
                        "openLink": {
                           "url": "https://example.com/share"
                         }
                       }
                     },
                     {
                       "text": "Edit",
                       "onClick": {
                         "action": {
                           "function": "goToView",
                           "parameters": [
                             {
                               "key": "viewType",
                               "value": "EDIT"
                             }
                           ]
                         }
                       }
                     }
                   ]
                 }
               }
             ]
           }
         ]
       }
    }
  ]
}

الحقول
`header`	`CardHeader` عنوان البطاقة يحتوي العنوان عادةً على صورة رئيسية وعنوان. تظهر الرؤوس دائمًا في أعلى البطاقة.
`sections[]`	`Section` يحتوي على مجموعة من التطبيقات المصغّرة. يحتوي كل قسم على عنوان اختياري خاص به. يتم فصل الأقسام بصريًا باستخدام فاصل سطر. للاطّلاع على مثال في تطبيقات Google Chat، يمكنك قراءة مقالة تحديد قسم في بطاقة.
`sectionDividerStyle`	`DividerStyle` نمط الفاصل بين الرأس والأقسام والتذييل.
`cardActions[]`	`CardAction` إجراءات البطاقة تتم إضافة الإجراءات إلى قائمة شريط أدوات البطاقة. تتوفّر هذه الميزة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat. على سبيل المثال، ينشئ ملف JSON التالي قائمة إجراءات بطاقة تتضمّن الخيارَين `Settings` و`Send Feedback`: `"cardActions": [ { "actionLabel": "Settings", "onClick": { "action": { "functionName": "goToView", "parameters": [ { "key": "viewType", "value": "SETTING" } ], "loadIndicator": "LoadIndicator.SPINNER" } } }, { "actionLabel": "Send Feedback", "onClick": { "openLink": { "url": "https://example.com/feedback" } } } ]`
`name`	`string` اسم البطاقة يتم استخدامه كمعرّف بطاقة في التنقّل بالبطاقة. متاحة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat.
`fixedFooter`	`CardFixedFooter` التذييل الثابت الذي يظهر في أسفل هذه البطاقة يؤدي ضبط `fixedFooter` بدون تحديد `primaryButton` أو `secondaryButton` إلى حدوث خطأ. بالنسبة إلى تطبيقات Chat، يمكنك استخدام التذييلات الثابتة في مربعات الحوار، وليس في رسائل البطاقات. متاحة لتطبيقات Google Chat وإضافات Google Workspace.
`displayStyle`	`DisplayStyle` في إضافات Google Workspace، تُستخدَم لضبط سمات العرض الخاصة بـ `peekCardHeader`. متاحة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat.
`peekCardHeader`	`CardHeader` عند عرض محتوى سياقي، يعمل عنوان البطاقة المعروضة بشكل خاطئ كعنصر نائب حتى يتمكّن المستخدم من التنقّل إلى الأمام بين بطاقات الصفحة الرئيسية والبطاقات السياقية. تتوفّر هذه الميزة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat.

CardAction

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

تتوفّر هذه الميزة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat.

الحقول

الحقول
`actionLabel`	`string` التصنيف الذي يظهر كعنصر في قائمة الإجراءات.
`onClick`	`OnClick` إجراء `onClick` الخاص ببنود العمل هذه.

actionLabel

string

التصنيف الذي يظهر كعنصر في قائمة الإجراءات.

onClick

OnClick

إجراء onClick الخاص ببنود العمل هذه.

CardFixedFooter

تذييل ثابت يظهر في أسفل البطاقة.

يؤدي ضبط fixedFooter بدون تحديد primaryButton أو secondaryButton إلى حدوث خطأ.

بالنسبة إلى تطبيقات Chat، يمكنك استخدام التذييلات الثابتة في مربعات الحوار، وليس في رسائل البطاقات. للحصول على مثال في تطبيقات Google Chat، اطّلِع على إضافة تذييل دائم.

متاحة لتطبيقات Google Chat وإضافات Google Workspace.

الحقول

الحقول
`primaryButton`	`Button` الزر الأساسي للتذييل الثابت. يجب أن يكون الزر زر نص مع ضبط النص واللون.
`secondaryButton`	`Button` الزر الثانوي للجزء السفلي الثابت يجب أن يكون الزر زر نص مع ضبط النص واللون. إذا تم ضبط `secondaryButton`، يجب أيضًا ضبط `primaryButton`.

primaryButton

Button

الزر الأساسي للتذييل الثابت. يجب أن يكون الزر زر نص مع ضبط النص واللون.

secondaryButton

Button

الزر الثانوي للجزء السفلي الثابت يجب أن يكون الزر زر نص مع ضبط النص واللون. إذا تم ضبط secondaryButton، يجب أيضًا ضبط primaryButton.

CardHeader

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

متاحة لتطبيقات Google Chat وإضافات Google Workspace.

الحقول
`title`	`string` مطلوب. عنوان عنوان البطاقة. يكون للعنوان ارتفاع ثابت: إذا تم تحديد عنوان وعنوان فرعي، يشغل كل منهما سطرًا واحدًا. إذا تم تحديد العنوان فقط، سيشغل كلا السطرين.
`subtitle`	`string` العنوان الفرعي لعنوان البطاقة. إذا تم تحديده، يظهر في سطر منفصل أسفل `title`.
`imageType`	`ImageType` الشكل المستخدَم لاقتصاص الصورة متاحة لتطبيقات Google Chat وإضافات Google Workspace.
`imageUrl`	`string` عنوان URL يستخدم HTTPS للصورة في عنوان البطاقة.
`imageAltText`	`string` النص البديل لهذه الصورة المستخدَم لتسهيل الاستخدام

DisplayStyle

يتم تحديد كيفية عرض البطاقة في إضافات Google Workspace.

متاحة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat.

عمليات التعداد
`DISPLAY_STYLE_UNSPECIFIED`	يُرجى عدم استخدامها. غير محدد
`PEEK`	يظهر عنوان البطاقة في أسفل الشريط الجانبي، ويغطي جزئيًا البطاقة العلوية الحالية من الحزمة. يؤدي النقر على العنوان إلى ظهور البطاقة في حزمة البطاقات. إذا لم تتضمّن البطاقة عنوانًا، يتم استخدام عنوان تم إنشاؤه بدلاً من ذلك.
`REPLACE`	القيمة التلقائية. يتم عرض البطاقة من خلال استبدال عرض البطاقة العلوية في حزمة البطاقات.

DividerStyle

نمط الفاصل في البطاقة لا تُستخدَم حاليًا إلا كمقسّمات بين أقسام البطاقة.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

عمليات التعداد
`DIVIDER_STYLE_UNSPECIFIED`	يُرجى عدم استخدامها. غير محدد
`SOLID_DIVIDER`	الخيار التلقائي اعرض مُقسّمًا مصمتًا.
`NO_DIVIDER`	في حال ضبطه، لن يتم عرض أي فاصل. يزيل هذا النمط المقسم تمامًا من التنسيق. والنتيجة هي ما يعادل عدم إضافة فاصل على الإطلاق.

القسم

يحتوي القسم على مجموعة من التطبيقات المصغّرة التي يتم عرضها عموديًا بالترتيب المحدّد.

متاحة لتطبيقات Google Chat وإضافات Google Workspace.

الحقول
`header`	`string` النص الذي يظهر في أعلى قسم دعم نص بسيط بتنسيق HTML. لمزيد من المعلومات عن تنسيق النص، يُرجى الاطّلاع على مقالتَي تنسيق النص في تطبيقات Google Chat وتنسيق النص في إضافات Google Workspace.
`widgets[]`	`Widget` جميع التطبيقات المصغّرة في القسم يجب أن يحتوي على تطبيق مصغّر واحد على الأقل.
`collapsible`	`bool` تشير هذه السمة إلى ما إذا كان هذا القسم قابلاً للتصغير. تخفي الأقسام القابلة للتصغير بعض الأدوات أو جميعها، لكن يمكن للمستخدمين توسيع القسم لكشف التطبيقات المصغّرة المخفية من خلال النقر على عرض المزيد. يمكن للمستخدمين إخفاء الأدوات مرة أخرى عن طريق النقر على عرض عناصر أقل. لتحديد التطبيقات المصغّرة المخفية، حدِّد `uncollapsibleWidgetsCount`.
`uncollapsibleWidgetsCount`	`int32` عدد التطبيقات المصغّرة غير القابلة للتصغير التي تبقى مرئية حتى عند تصغير قسم. على سبيل المثال، عندما يحتوي قسم على خمس أدوات ويتم ضبط `uncollapsibleWidgetsCount` على `2`، يتم دائمًا عرض أول أداتَين ويتم تصغير آخر ثلاث تطبيقات مصغّرة تلقائيًا. لا يتمّ احتساب `uncollapsibleWidgetsCount` إلّا عندما يكون `collapsible` يساوي `true`.
`collapseControl`	`CollapseControl` اختياريّ. حدِّد زرّ توسيع القسم وتصغيره. لن يظهر هذا الزر إلا إذا كان القسم قابلاً للتصغير. في حال عدم ضبط هذا الحقل، يتم استخدام الزر التلقائي. متاحة لتطبيقات Google Chat وغير متاحة لإضافات Google Workspace.

شريحة

نص أو رمز أو شريحة نص ورمز يمكن للمستخدمين النقر عليها

متاحة لتطبيقات Google Chat وغير متاحة لإضافات Google Workspace.

الحقول
`icon`	`Icon` صورة الرمز إذا تم ضبط `icon` و`text`، سيظهر الرمز قبل النص.
`label`	`string` النص المعروض داخل الشريحة
`onClick`	`OnClick` اختياريّ. الإجراء الذي سيتم تنفيذه عندما ينقر المستخدم على الشريحة، مثل فتح رابط تشعبي أو تشغيل دالة مخصّصة.
`enabled (deprecated)`	`bool` تم إيقاف هذا العنصر نهائيًا. ما إذا كانت الشريحة في حالة نشطة وتستجيب لإجراءات المستخدم وتكون القيمة التلقائية هي `true`. تمّ الإيقاف. استخدِم `disabled` بدلاً من ذلك.
`disabled`	`bool` ما إذا كانت الشريحة في حالة غير نشطة وتتجاهل إجراءات المستخدم وتكون القيمة التلقائية هي `false`.
`altText`	`string` النص البديل المستخدَم لتحسين إمكانية الاستخدام اضبط نصًا وصفيًا يُعلِم المستخدمين بوظائف الشريحة. على سبيل المثال، إذا كانت الشريحة تفتح رابطًا تشعبيًا، اكتب: "فتح علامة تبويب جديدة في المتصفّح والانتقال إلى مستندات مطوّري Google Chat على الرابط https://developers.google.com/workspace/chat".

ChipList

قائمة بالشرائح يتم وضعها أفقيًا، والتي يمكنها إما التمرير أفقيًا أو التفافها إلى السطر التالي.

متاحة لتطبيقات Google Chat وغير متاحة لإضافات Google Workspace.

الحقول

الحقول
`layout`	`Layout` تنسيق قائمة الشرائح المحدّد.
`chips[]`	`Chip` مصفوفة من الشرائح.

layout

Layout

تنسيق قائمة الشرائح المحدّد.

chips[]

Chip

مصفوفة من الشرائح.

التنسيق

تنسيق قائمة الشرائح

عمليات التعداد
`LAYOUT_UNSPECIFIED`	لا تستخدِم هذه الميزة. غير محدد
`WRAPPED`	القيمة التلقائية. يتم عرض قائمة الشرائح في السطر التالي إذا لم تكن هناك مساحة أفقية كافية.
`HORIZONTAL_SCROLLABLE`	يتم تمرير الشرائح أفقيًا في حال عدم تناسبها مع المساحة المتاحة.

CollapseControl

مثِّل أحد عناصر التحكُّم في التوسيع والتصغير. متاحة لتطبيقات Google Chat وغير متاحة لإضافات Google Workspace.

الحقول

الحقول
`horizontalAlignment`	`HorizontalAlignment` المحاذاة الأفقية لزرَي التوسيع والتصغير
`expandButton`	`Button` اختياريّ. حدِّد زرًا قابلاً للتخصيص لتوسيع القسم. يجب ضبط الحقلين expandButton وcollapseButton. لن يتم تفعيل مجموعة حقول واحدة فقط. في حال عدم ضبط هذا الحقل، يتم استخدام الزر التلقائي.
`collapseButton`	`Button` اختياريّ. حدِّد زرًا قابلاً للتخصيص لتصغير القسم. يجب ضبط كل من حقل extendButton وzoomButton. لن يتم تفعيل مجموعة حقول واحدة فقط. في حال عدم ضبط هذا الحقل، يتم استخدام الزر التلقائي.

horizontalAlignment

HorizontalAlignment

المحاذاة الأفقية لزرَي التوسيع والتصغير

expandButton

Button

اختياريّ. حدِّد زرًا قابلاً للتخصيص لتوسيع القسم. يجب ضبط الحقلين expandButton وcollapseButton. لن يتم تفعيل مجموعة حقول واحدة فقط. في حال عدم ضبط هذا الحقل، يتم استخدام الزر التلقائي.

collapseButton

Button

اختياريّ. حدِّد زرًا قابلاً للتخصيص لتصغير القسم. يجب ضبط كل من حقل extendButton وzoomButton. لن يتم تفعيل مجموعة حقول واحدة فقط. في حال عدم ضبط هذا الحقل، يتم استخدام الزر التلقائي.

الأعمدة

تعرِض الأداة المصغّرة Columns ما يصل إلى عمودَين في بطاقة أو مربّع حوار. يمكنك إضافة تطبيقات مصغّرة إلى كل عمود، وستظهر التطبيقات المصغّرة بالترتيب المحدّد. للاطّلاع على مثال في تطبيقات Google Chat، يمكنك قراءة مقالة عرض البطاقات ومربّعات الحوار في الأعمدة.

يتم تحديد ارتفاع كل عمود حسب العمود الأطول. على سبيل المثال، إذا كان العمود الأول أطول من العمود الثاني، يكون ارتفاع كلا العمودَين هو ارتفاع العمود الأول. وبما أنّ كل عمود يمكن أن يحتوي على عدد مختلف من التطبيقات المصغّرة، لا يمكنك تحديد الصفوف أو محاذاة التطبيقات المصغّرة بين الأعمدة.

يتم عرض الأعمدة جنبًا إلى جنب. يمكنك تخصيص عرض كل عمود باستخدام الحقل HorizontalSizeStyle. إذا كان عرض شاشة المستخدم ضيقًا جدًا، يتمّ عرض العمود الثاني أسفل الأول:

على الويب، يتم التفاف العمود الثاني إذا كان عرض الشاشة أقل من أو يساوي 480 بكسل.
على أجهزة iOS، يتمّ عرض العمود الثاني على عدة أسطر إذا كان عرض الشاشة أقل من أو يساوي 300 نقطة.
على أجهزة Android، يتمّ عرض العمود الثاني على عدة أسطر إذا كان عرض الشاشة أقل من 320 وحدة بكسل مستقلة الكثافة أو يساويها.

لتضمين أكثر من عمودَين أو لاستخدام الصفوف، استخدِم التطبيق المصغّر Grid.

متاحة لتطبيقات Google Chat وإضافات Google Workspace. تشمل واجهات المستخدم للإضافات التي تتيح الأعمدة ما يلي:

مربّع الحوار الذي يظهر عندما يفتح المستخدمون الإضافة من مسودة رسالة إلكترونية
مربّع الحوار الذي يظهر عندما يفتح المستخدمون الإضافة من قائمة إضافة مرفق في حدث على "تقويم Google"

الحقول

الحقول
`columnItems[]`	`Column` مصفوفة من الأعمدة. يمكنك تضمين عمودَين بحدّ أقصى في بطاقة أو مربّع حوار.

columnItems[]

Column

مصفوفة من الأعمدة. يمكنك تضمين عمودَين بحدّ أقصى في بطاقة أو مربّع حوار.

العمود

عمود

إضافات Google Workspace وتطبيقات Chat

الحقول
`horizontalSizeStyle`	`HorizontalSizeStyle` تُحدِّد كيفية ملء عمود لعرض البطاقة.
`horizontalAlignment`	`HorizontalAlignment` لتحديد ما إذا كانت الأدوات تتم محاذاة إلى اليسار أو اليمين أو منتصف العمود.
`verticalAlignment`	`VerticalAlignment` لتحديد ما إذا كانت التطبيقات المصغّرة تتم محاذاتها في أعلى أو أسفل أو وسط عمود
`widgets[]`	`Widgets` صفيف من التطبيقات المصغّرة المضمّنة في عمود تظهر التطبيقات المصغّرة بالترتيب الذي تم تحديدها به.

HorizontalSizeStyle

تُحدِّد كيفية ملء عمود لعرض البطاقة. ويعتمد عرض كل عمود على HorizontalSizeStyle وعرض الأدوات داخل العمود.

إضافات Google Workspace وتطبيقات Chat

عمليات التعداد
`HORIZONTAL_SIZE_STYLE_UNSPECIFIED`	لا تستخدِم هذه الميزة. غير محدد
`FILL_AVAILABLE_SPACE`	القيمة التلقائية يملؤه العمود المساحة المتوفّرة، بما يصل إلى %70 من عرض البطاقة. إذا تم ضبط كلا العمودين على `FILL_AVAILABLE_SPACE`، يملأ كل عمود 50% من المساحة.
`FILL_MINIMUM_SPACE`	يملؤه العمود أقل مساحة ممكنة ولا يتجاوز 30% من عرض البطاقة.

VerticalAlignment

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

إضافات Google Workspace وتطبيقات Chat

عمليات التعداد
`VERTICAL_ALIGNMENT_UNSPECIFIED`	لا تستخدِم هذه الميزة. غير محدد
`CENTER`	القيمة التلقائية محاذاة التطبيقات المصغّرة في وسط عمود
`TOP`	لمحاذاة الأدوات مع أعلى عمود.
`BOTTOM`	محاذاة التطبيقات المصغّرة في أسفل عمود

التطبيقات المصغَّرة

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

إضافات Google Workspace وتطبيقات Chat

الحقول
حقل الربط `data` يمكن أن يكون `data` واحدًا فقط مما يلي:
`textParagraph`	`TextParagraph` أداة `TextParagraph`.
`image`	`Image` أداة `Image`.
`decoratedText`	`DecoratedText` أداة `DecoratedText`.
`buttonList`	`ButtonList` أداة `ButtonList`.
`textInput`	`TextInput` أداة `TextInput`.
`selectionInput`	`SelectionInput` أداة `SelectionInput`.
`dateTimePicker`	`DateTimePicker` أداة `DateTimePicker`.
`chipList`	`ChipList` أداة `ChipList`. متاحة لتطبيقات Google Chat وغير متاحة لإضافات Google Workspace.

DateTimePicker

تتيح للمستخدمين إدخال تاريخ أو وقت أو تاريخ ووقت معًا. للاطّلاع على مثال في تطبيقات Google Chat، راجِع السماح للمستخدم باختيار تاريخ ووقت.

يمكن للمستخدمين إدخال نص أو استخدام أداة الاختيار لتحديد التواريخ والأوقات. إذا أدخل المستخدمون تاريخًا أو وقتًا غير صالحين، تعرض أداة الاختيار خطأً يطلب من المستخدمين إدخال المعلومات بشكل صحيح.

متاحة لتطبيقات Google Chat وإضافات Google Workspace.

الحقول
`name`	`string` الاسم الذي يتم من خلاله التعرّف على `DateTimePicker` في حدث إدخال نموذج. لمعرفة التفاصيل حول التعامل مع إدخالات النماذج، يُرجى الاطّلاع على تلقّي بيانات النماذج.
`label`	`string` النص الذي يطلب من المستخدمين إدخال تاريخ أو وقت أو تاريخ ووقت. على سبيل المثال، إذا كان المستخدمون يحجزون موعدًا، استخدِم تصنيفًا مثل `Appointment date` أو `Appointment date and time`.
`type`	`DateTimePickerType` ما إذا كان التطبيق المصغّر يتيح إدخال تاريخ أو وقت أو التاريخ والوقت معًا
`valueMsEpoch`	`int64` القيمة التلقائية المعروضة في الأداة بالمللي ثانية منذ وقت حقبة يونكس حدِّد القيمة استنادًا إلى نوع أداة الاختيار (`DateTimePickerType`): ‫`DATE_AND_TIME`: تاريخ تقويمي ووقت بالتوقيت العالمي المنسق على سبيل المثال، لتمثيل 1 كانون الثاني (يناير) 2023 في الساعة 12:00 مساءً بالتوقيت العالمي المتّفق عليه، استخدِم `1672574400000`. ‫`DATE_ONLY`: تاريخ تقويمي في الساعة 00:00:00 بالتوقيت العالمي المنسّق على سبيل المثال، للتعبير عن 1 كانون الثاني (يناير) 2023، استخدِم `1672531200000`. ‫`TIME_ONLY`: وقت بالتوقيت العالمي المنسق على سبيل المثال، لتمثيل الساعة 12:00 بعد الظهر، استخدِم `43200000` (أو `12 * 60 * 60 * 1000`).
`timezoneOffsetDate`	`int32` يمثّل هذا الرقم فرق التوقيت بالساعات والدقائق بين المنطقة الزمنية والتوقيت العالمي المنسق. وفي حال ضبطها، يتم عرض `value_ms_epoch` حسب المنطقة الزمنية المحدّدة. وفي حال ترك هذه السياسة بدون ضبط، يتم ضبط القيمة تلقائيًا على إعداد المنطقة الزمنية للمستخدم.
`onChangeAction`	`Action` يتم تشغيله عندما ينقر المستخدِم على حفظ أو محو من واجهة `DateTimePicker`.
`validation`	`Validation` إصدار المطوّر: يتوفّر كجزء من برنامج إصدار المطوّر في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة. اختياريّ. حدِّد عملية التحقّق المطلوبة لأداة اختيار الموقّت والتاريخ هذه. متاحة لتطبيقات Google Chat وإضافات Google Workspace.

DateTimePickerType

تنسيق التاريخ والوقت في التطبيق المصغّر DateTimePicker يحدِّد هذا الإعداد ما إذا كان يمكن للمستخدمين إدخال تاريخ أو وقت أو تاريخ ووقت معًا.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

عمليات التعداد
`DATE_AND_TIME`	يُدخل المستخدمون تاريخًا ووقتًا.
`DATE_ONLY`	يُدخل المستخدمون تاريخًا.
`TIME_ONLY`	يُدخِل المستخدمون وقتًا.

DecoratedText

تطبيق مصغّر يعرض نصًا مع زخارف اختيارية، مثل تصنيف أعلى النص أو أسفله أو رمز أمام النص أو تطبيق مصغّر للاختيار أو زر بعد النص للاطّلاع على مثال في تطبيقات Google Chat، يُرجى الاطّلاع على عرض نص مع نص زخرفي.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

الحقول
`icon (deprecated)`	`Icon` تم إيقاف هذا العنصر نهائيًا. تم إيقافها لصالح `startIcon`.
`startIcon`	`Icon` الرمز المعروض أمام النص
`topLabel`	`string` النص الذي يظهر أعلى `text`. يتم اقتطاعها دائمًا.
`text`	`string` مطلوب. النص الأساسي. تتيح التنسيق البسيط. لمزيد من المعلومات عن تنسيق النص، يُرجى الاطّلاع على مقالتَي تنسيق النص في تطبيقات Google Chat وتنسيق النص في إضافات Google Workspace.
`wrapText`	`bool` إعداد التفاف النص إذا كان `true`، يتمّ عرض النص على عدّة أسطر. وإلا، سيتم اقتطاع النص. ينطبق التغيير على `text` فقط، وليس على `topLabel` و`bottomLabel`.
`bottomLabel`	`string` النص الذي يظهر تحت `text`. التفاف النص دائمًا
`onClick`	`OnClick` يتم بدء هذا الإجراء عندما ينقر المستخدمون على `topLabel` أو `bottomLabel`.
حقل الربط `control` زر أو مفتاح تبديل أو مربّع اختيار أو صورة تظهر على الجانب الأيسر من النص في تطبيق "`decoratedText`" المصغّر. يمكن أن يكون `control` واحدًا فقط مما يلي:
`button`	`Button` زر يمكن للمستخدم النقر عليه لتشغيل إجراء.
`switchControl`	`SwitchControl` تطبيق مصغّر للتبديل يمكن للمستخدم النقر عليه لتغيير حالته وتنفيذ إجراء.
`endIcon`	`Icon` رمز يظهر بعد النص تتيح استخدام الرموز المضمّنة والمخصّصة.

عنصر تحكم التبديل

مفتاح تبديل بنمط التبديل أو مربّع اختيار داخل تطبيق decoratedText المصغّر.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

لا يمكن تنفيذ هذا الإجراء إلّا في تطبيق "decoratedText" المصغّر.

الحقول
`name`	`string` الاسم الذي يتم من خلاله التعرّف على التطبيق المصغّر للتبديل في حدث إدخال نموذج. لمعرفة تفاصيل عن التعامل مع إدخالات النماذج، يُرجى الاطّلاع على تلقي بيانات النموذج.
`value`	`string` القيمة التي أدخلها المستخدم، ويتم عرضها كجزء من حدث إدخال النموذج. لمعرفة التفاصيل حول التعامل مع إدخالات النماذج، يُرجى الاطّلاع على تلقّي بيانات النماذج.
`selected`	`bool` عندما يكون `true`، يكون المفتاح مفعّلاً.
`onChangeAction`	`Action` الإجراء الذي يتم تنفيذه عند تغيير حالة مفتاح التبديل، مثل الدالة المطلوب تشغيلها.
`controlType`	`ControlType` كيفية ظهور المفتاح في واجهة المستخدم تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

ControlType

كيفية ظهور مفتاح التبديل في واجهة المستخدم

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

عمليات التعداد
`SWITCH`	مفتاح تبديل بنمط الإيقاف/التفعيل
`CHECKBOX`	تمّ إيقاف هذا العمود نهائيًا واستبداله بالعمود `CHECK_BOX`.
`CHECK_BOX`	مربّع اختيار

حاجز

لا يتضمّن هذا النوع أيّ حقول.

تعرِض هذه السمة فاصلاً بين التطبيقات المصغّرة على شكل خط أفقي. للاطّلاع على مثال في تطبيقات Google Chat، يمكنك الاطّلاع على إضافة فاصل أفقي بين التطبيقات المصغّرة.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

على سبيل المثال، ينشئ ملف JSON التالي مُقسّمًا:

"divider": {}

EndNavigation

إجراء Dialogflow

متاحة لتطبيقات Google Chat وغير متاحة لإضافات Google Workspace.

الحقول

action

Action

إجراء العرض للعميل لإنهاء مسار حوار.

متاحة لتطبيقات Google Chat وغير متاحة لإضافات Google Workspace.

الإجراء

أنواع إجراءات العرض التي ينفّذها العميل لإنهاء مسار حوار

تتوفّر هذه الميزة لتطبيقات Google Chat ولا تتوفّر لإضافات Google Workspace.

عمليات التعداد
`ACTION_UNSPECIFIED`	لم يتم تحديد الإجراء.
`CLOSE_DIALOG`	إغلاق عملية الحوار
`CLOSE_DIALOG_AND_EXECUTE`	يمكنك إغلاق مربّع الحوار وإعادة تحميل البطاقة التي أدّت إلى فتح مربّع الحوار.

GetAutocompletionResponse

ردّ على الحصول على حاوية الإكمال التلقائي، والتي تتضمّن العناصر اللازمة لعرض عناصر الإكمال التلقائي لحقل النص

متاحة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat. على سبيل المثال:

{
  "autoComplete": {
    "items": [
      {
        "text": "C++"
      },
      {
        "text": "Java"
      },
      {
        "text": "JavaScript"
      },
      {
        "text": "Python"
      }
    ]
  }
}

الحقول

الحقول
`autoComplete`	`Suggestions`
`schema`	`string` وهذا حقل مخطّط مفتوح، قد يكون متوفّرًا في الترميز للتحقّق من البنية.

autoComplete

Suggestions

schema

string

وهذا حقل مخطّط مفتوح، قد يكون متوفّرًا في الترميز للتحقّق من البنية.

شبكة

تعرِض شبكة تتضمّن مجموعة من العناصر. يمكن أن تتضمن العناصر نصًا أو صورًا فقط. بالنسبة إلى الأعمدة السريعة الاستجابة أو لتضمين أكثر من نص أو صور، استخدِم Columns. للاطّلاع على مثال في تطبيقات Google Chat، يمكنك الاطّلاع على مقالة عرض شبكة تتضمّن مجموعة من العناصر.

تتيح الشبكة استخدام أي عدد من الأعمدة والعناصر. يتم تحديد عدد الصفوف من خلال قسمة العناصر على الأعمدة. الشبكة التي تحتوي على 10 عناصر وعمودين تحتوي على 5 صفوف. الشبكة التي تتكون من 11 عنصرًا وعمودين بها 6 صفوف.

متاحة لتطبيقات Google Chat وإضافات Google Workspace.

على سبيل المثال، ينشئ تنسيق JSON التالي شبكة من عمودَين تحتوي على عنصر واحد:

"grid": {
  "title": "A fine collection of items",
  "columnCount": 2,
  "borderStyle": {
    "type": "STROKE",
    "cornerRadius": 4
  },
  "items": [
    {
      "image": {
        "imageUri": "https://www.example.com/image.png",
        "cropStyle": {
          "type": "SQUARE"
        },
        "borderStyle": {
          "type": "STROKE"
        }
      },
      "title": "An item",
      "textAlignment": "CENTER"
    }
  ],
  "onClick": {
    "openLink": {
      "url": "https://www.example.com"
    }
  }
}

الحقول
`title`	`string` النص الذي يظهر في عنوان الشبكة
`items[]`	`GridItem` العناصر المراد عرضها في الشبكة.
`borderStyle`	`BorderStyle` نمط الحدود الذي سيتم تطبيقه على كل عنصر في الشبكة
`columnCount`	`int32` عدد الأعمدة المراد عرضها في الشبكة. يتم استخدام قيمة تلقائية إذا لم يتم تحديد هذا الحقل، وتختلف هذه القيمة التلقائية حسب مكان عرض الشبكة (في مربّع الحوار أو في الشريك).
`onClick`	`OnClick` تتم إعادة استخدام دالة الاستدعاء هذه بواسطة كل عنصر شبكة فردي، ولكن مع معرّف العنصر والفهرس في قائمة العناصر التي تمت إضافتها إلى مَعلمات معاودة الاتصال.

GridItem

تمثل عنصرًا في تنسيق الشبكة. يمكن أن تحتوي العناصر على نص أو صورة أو نصًا وصورة معًا.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

الحقول
`id`	`string` معرّف يحدّده المستخدم لعنصر الشبكة هذا. يتم عرض هذا المعرّف في مَعلمات معاودة الاتصال `onClick` الخاصة بالشبكة الرئيسية.
`image`	`ImageComponent` الصورة التي يتم عرضها في عنصر الشبكة
`title`	`string` عنوان عنصر الشبكة.
`subtitle`	`string` العنوان الفرعي لعنصر الشبكة
`layout`	`GridItemLayout` التنسيق الذي سيتم استخدامه لعنصر الشبكة.

GridItemLayout

تمثّل خيارات التنسيق المختلفة المتاحة لعنصر الشبكة.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

عمليات التعداد
`GRID_ITEM_LAYOUT_UNSPECIFIED`	لا تستخدِم هذه الميزة. غير محدد
`TEXT_BELOW`	يظهر العنوان والعنوان الفرعي أسفل صورة عنصر الشبكة.
`TEXT_ABOVE`	يظهر العنوان والعنوان الفرعي أعلى صورة عنصر الشبكة.

الرمز

رمز معروض في تطبيق مصغّر على بطاقة للاطّلاع على مثال في تطبيقات Google Chat، يمكنك قراءة مقالة إضافة رمز.

يتوافق مع الرموز المدمجة والمخصّصة.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

الحقول
`altText`	`string` اختياريّ. تمثّل هذه السمة وصف الرمز المستخدَم لإمكانية الوصول. إذا لم يتم تحديد قيمة هذه السمة، يتم توفير القيمة التلقائية `Button`. كأفضل ممارسة، يجب عليك إعداد وصف مفيد لما يعرضه الأيقونة، وما يفعله إن أمكن. على سبيل المثال، `A user's account portrait` أو `Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/workspace/chat`. إذا تم ضبط الرمز في `Button`، يظهر `altText` كنص مساعد عندما يمرّر المستخدم مؤشّر الماوس فوق الزر. وإذا ضبط الزر أيضًا `text`، سيتم تجاهل `altText` الخاصة بالرمز.
`imageType`	`ImageType` نمط الاقتصاص المطبّق على الصورة في بعض الحالات، يؤدي تطبيق عملية اقتصاص `CIRCLE` إلى رسم الصورة بحجم أكبر من الرمز المضمّن.
حقل الاتحاد `icons`. الرمز المعروض في التطبيق المصغّر على البطاقة يمكن أن يكون `icons` واحدًا فقط مما يلي:
`knownIcon`	`string` اعرض أحد الرموز المضمَّنة في Google Workspace. على سبيل المثال، لعرض رمز طائرة، حدِّد `AIRPLANE`. بالنسبة إلى الحافلة، حدِّد `BUS`. للحصول على قائمة كاملة بالرموز المتوافقة، راجِع الرموز المضمّنة.
`iconUrl`	`string` عرض رمز مخصّص مُستضاف على عنوان URL يستخدم HTTPS على سبيل المثال: `"iconUrl": "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png"` تشمل أنواع الملفات المتوافقة `.png` و`.jpg`.
`materialIcon`	`MaterialIcon` اعرض أحد رموز Materials من Google. على سبيل المثال، لعرض رمز مربع الاختيار، استخدم `"materialIcon": { "name": "check_box" }` تتوفّر هذه الميزة لتطبيقات Google Chat ولا تتوفّر لإضافات Google Workspace.

صورة

صورة يتم تحديدها من خلال عنوان URL ويمكن أن تحتوي على إجراء onClick. على سبيل المثال، انظر إضافة صورة.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

الحقول

الحقول
`imageUrl`	`string` عنوان URL يستخدم HTTPS الذي يستضيف الصورة. على سبيل المثال: `https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png`
`onClick`	`OnClick` عندما ينقر المستخدِم على الصورة، يؤدي النقر إلى بدء هذا الإجراء.
`altText`	`string` النص البديل لهذه الصورة المستخدَم لتسهيل الاستخدام

imageUrl

string

عنوان URL يستخدم HTTPS الذي يستضيف الصورة.

على سبيل المثال:

https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png

onClick

OnClick

عندما ينقر المستخدِم على الصورة، يؤدي النقر إلى بدء هذا الإجراء.

altText

string

النص البديل لهذه الصورة المستخدَم لتسهيل الاستخدام

ImageComponent

يمثل هذا العنصر صورة.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

الحقول
`imageUri`	`string` عنوان URL الخاص بالصورة
`altText`	`string` تصنيف تسهيل الاستخدام للصورة
`cropStyle`	`ImageCropStyle` نمط الاقتصاص المطلوب تطبيقه على الصورة
`borderStyle`	`BorderStyle` نمط الحدود المطلوب تطبيقه على الصورة.

ImageCropStyle

تمثّل نمط الاقتصاص الذي تم تطبيقه على صورة.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

على سبيل المثال، إليك كيفية تطبيق نسبة عرض إلى ارتفاع 16:9:

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}

الحقول

الحقول
`type`	`ImageCropType` نوع الاقتصاص
`aspectRatio`	`double` نسبة العرض إلى الارتفاع التي سيتم استخدامها إذا كان نوع الاقتصاص هو `RECTANGLE_CUSTOM`. على سبيل المثال، إليك كيفية تطبيق نسبة العرض إلى الارتفاع 16:9: `cropStyle { "type": "RECTANGLE_CUSTOM", "aspectRatio": 16/9 }`

type

ImageCropType

نوع الاقتصاص

aspectRatio

double

نسبة العرض إلى الارتفاع التي سيتم استخدامها إذا كان نوع الاقتصاص هو RECTANGLE_CUSTOM.

على سبيل المثال، إليك كيفية تطبيق نسبة العرض إلى الارتفاع 16:9:

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}

ImageCropType

تمثّل نمط الاقتصاص الذي تم تطبيقه على صورة.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

عمليات التعداد
`IMAGE_CROP_TYPE_UNSPECIFIED`	لا تستخدِم هذه الميزة. غير محدد
`SQUARE`	القيمة التلقائية لتطبيق اقتصاص مربّع.
`CIRCLE`	لتطبيق اقتصاص دائري.
`RECTANGLE_CUSTOM`	يتم تطبيق اقتصاص مستطيل بنسبة عرض إلى ارتفاع مخصّصة. اضبط نسبة العرض إلى الارتفاع المخصّصة باستخدام `aspectRatio`.
`RECTANGLE_4_3`	لتطبيق اقتصاص مستطيل بنسبة عرض إلى ارتفاع 4:3.

رابط

كائن الرابط للمورد التابع لجهة خارجية الذي يتم عرضه إلى الإضافة لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء موارد تابعة لجهات خارجية من قائمة "@".

تتوفّر هذه الميزة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat.

الحقول

الحقول
`url`	`string` عنوان URL للرابط للرجوع إلى الإضافة.
`title`	`string` عنوان الرابط للعودة إلى الإضافة

url

string

عنوان URL للرابط للرجوع إلى الإضافة.

title

string

عنوان الرابط للعودة إلى الإضافة

LinkPreview

إجراء البطاقة الذي يعرِض معاينة لرابط تابع لجهة خارجية من خلال عرض بطاقة وشريحة ذكية لمزيد من المعلومات، اطّلِع على مقالة معاينة الروابط باستخدام الشرائح الذكية.

تتوفّر هذه الميزة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat.

على سبيل المثال، يعرض ملف JSON التالي عنوانًا فريدًا لمعاينة الرابط والشريحة الذكية وبطاقة معاينة تحتوي على عنوان ووصف نصي:

{
  "action": {
    "linkPreview": {
      "title": "Smart chip title",
      "linkPreviewTitle": "Link preview title",
      "previewCard": {
        "header": {
          "title": "Preview card header",
        },
        "sections": [
          {
            "widgets": [
              {
                "textParagraph": {
                  "text": "Description of the link."
                }
              }
            ]
          }
        ]
      }
    }
  }
}

يعرض المثال معاينة الرابط التالي:

مثال على معاينة الرابط

الحقول

الحقول
`previewCard`	`Card` بطاقة تعرض معلومات حول رابط من خدمة تابعة لجهة خارجية
`title`	`string` هو العنوان الذي يظهر في الشريحة الذكية لمعاينة الرابط. في حال عدم ضبط هذه السمة، ستعرض الشريحة الذكية العنوان الخاص بـ `preview_card`.
`linkPreviewTitle`	`string` العنوان الذي يظهر في معاينة الرابط. في حال عدم ضبط هذا الخيار، ستعرض معاينة الرابط العنوان الخاص بـ `preview_card`.

previewCard

Card

بطاقة تعرض معلومات حول رابط من خدمة تابعة لجهة خارجية

title

string

هو العنوان الذي يظهر في الشريحة الذكية لمعاينة الرابط. في حال عدم ضبط هذه السمة، ستعرض الشريحة الذكية العنوان الخاص بـ preview_card.

linkPreviewTitle

string

العنوان الذي يظهر في معاينة الرابط. في حال عدم ضبط هذا الخيار، ستعرض معاينة الرابط العنوان الخاص بـ preview_card.

MaterialIcon

رمز Google Material الذي يتضمن أكثر من 2500 خيار

على سبيل المثال، لعرض رمز مربّع اختيار بدرجة ووزن مخصّصَين، اكتب ما يلي:

{
  "name": "check_box",
  "fill": true,
  "weight": 300,
  "grade": -25
}

متاحة لتطبيقات Google Chat وغير متاحة لإضافات Google Workspace.

الحقول
`name`	`string` اسم الرمز المحدّد في رمز Google Material، على سبيل المثال، `check_box`. يتم تجاهل أي أسماء غير صالحة واستبدالها بسلسلة فارغة، ما يؤدّي إلى تعذُّر عرض الرمز.
`fill`	`bool` ما إذا كان سيتم عرض الرمز كممتلئ. القيمة التلقائية هي خطأ. لمعاينة إعدادات الرموز المختلفة، انتقِل إلى رموز خطوط Google واضبط الإعدادات ضمن تخصيص.
`weight`	`int32` كثافة خط الرمز يمكنك الاختيار من بين {100, 200, 300, 400, 500, 600, 700}. في حال عدم توفّر هذه المعلومات، تكون القيمة التلقائية 400. إذا تم تحديد أي قيمة أخرى، يتم استخدام القيمة التلقائية. لمعاينة إعدادات الرموز المختلفة، انتقِل إلى رموز خطوط Google واضبط الإعدادات ضمن تخصيص.
`grade`	`int32` يؤثران في سمك الرمز. إنّ تعديلات الدرجة أكثر دقة من تعديلات الوزن ولها تأثير بسيط في حجم الرمز. اختَر من بين {-25, 0, 200}. إذا لم تكن متوفّرة، تكون القيمة التلقائية هي 0. إذا تم تحديد أي قيمة أخرى، يتم استخدام القيمة التلقائية. لمعاينة إعدادات الرموز المختلفة، انتقِل إلى رموز خطوط Google واضبط الإعدادات ضمن تخصيص.

إجراء على البطاقة يتلاعب بحزمة البطاقات.

على سبيل المثال:

1) إضافة بطاقة جديدة إلى الحزمة (الانتقال للأمام) بالنسبة إلى تطبيقات Chat، لا تتوفّر هذه الميزة إلا في صفحة تطبيقك الرئيسية.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

 navigations : {
    pushCard : CARD
  }

2) تعديل البطاقة في أعلى الحزمة (إجراء تعديل مكانه)

متاحة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat.

  navigations : {
    popCard : true,
  }, {
    pushCard : CARD
  }

3) الرجوع خطوة واحدة بدون تحديث.

تتوفّر هذه الميزة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat.

  navigations : {
    popCard : true,
  }

4) الرجوع إلى عدة خطوات وتعديل تلك البطاقة

تتوفّر هذه الميزة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat.

  navigations : {
    popCard : true,
  }, ... {
    pushCard : CARD
  }

5) الرجوع إلى عدة خطوات إلى CARD_NAME محدّد

متاحة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat.

  navigations : {
    popToCardName : CARD_NAME,
  }, {
    pushCard : CARD
  }

6) ارجع إلى الجذر وعدِّل تلك البطاقة.

تتوفّر هذه الميزة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat.

  navigations : {
    popToRoot : true
  }, {
    pushCard : CARD
  }

7) انتقل إلى البطاقة المحددة وافصلها أيضًا.

تتوفّر هذه الميزة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat.

navigations : { popToCardName : CARD_NAME }, { popCard : true, }

8) استبدِل البطاقة العلوية ببطاقة جديدة. بالنسبة إلى تطبيقات Chat، لا تتوفّر هذه الميزة إلا في صفحة تطبيقك الرئيسية.

متاحة لتطبيقات Google Chat وإضافات Google Workspace.

  navigations : {
    updateCard : CARD
  }

الحقول
حقل الربط `navigate_action` يمكن أن يكون `navigate_action` واحدًا فقط مما يلي:
`popToRoot`	`bool` تنبثق حزمة البطاقات من كل البطاقات باستثناء بطاقة الجذر.
`pop`	`bool` تُخرج حزمة البطاقات بطاقة واحدة.
`popToCard`	`string` تنبثق حزمة البطاقات من كل البطاقات فوق البطاقة المحدَّدة التي تحمل اسم البطاقة.
`pushCard`	`Card` تدفع حزمة البطاقات بطاقة إلى حزمة البطاقات.
`updateCard`	`Card` تعدّل حزمة البطاقات البطاقة العلوية من خلال إضافة بطاقة جديدة مع الاحتفاظ بقيم حقول النموذج المعبأة. بالنسبة إلى الحقل غير المكافئ، يتم حذف القيمة.
`endNavigation`	`EndNavigation` إجراء التنقّل في نهاية مسار مربّع الحوار لمزيد من المعلومات، راجِع المقالة إنشاء صفحة رئيسية لتطبيق Google Chat. متاحة لتطبيقات Google Chat وغير متاحة لإضافات Google Workspace.

إشعار

إجراء البطاقة الذي يعرض إشعارًا في التطبيق المضيف

متاحة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat.

الحقول

الحقول
`text`	`string` نص عادي يتم عرضه للإشعار بدون علامات HTML.

text

string

نص عادي يتم عرضه للإشعار بدون علامات HTML.

OnClick

يمثّل كيفية الردّ عندما ينقر المستخدِمون على عنصر تفاعلي في البطاقة، مثل زر.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

الحقول
حقل الربط `data` يمكن أن يكون `data` واحدًا فقط مما يلي:
`action`	`Action` سيتم تنفيذ الإجراء من خلال سمة `onClick` هذه في حال تحديدها.
`openLink`	`OpenLink` في حال تحديد `onClick`، يؤدّي ذلك إلى تشغيل إجراء رابط مفتوح.
`openDynamicLinkAction`	`Action` تُشغِّل إحدى الإضافات هذا الإجراء عندما يحتاج الإجراء إلى فتح رابط. يختلف ذلك عن `open_link` أعلاه في أنّ هذا الإجراء يحتاج إلى التواصل مع الخادم للحصول على الرابط. وبالتالي، يجب أن يتّخذ برنامج الويب بعض الإجراءات التحضيرية قبل أن يظهر الرد على إجراء الرابط المفتوح. تتوفّر هذه الميزة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat.
`card`	`Card` يتم دفع بطاقة جديدة إلى حزمة البطاقات بعد النقر عليها إذا تم تحديدها. متاحة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat.
`overflowMenu`	`OverflowMenu` يؤدي هذا الرمز `onClick` إلى فتح قائمة سياقية في حال تحديده. متاحة لتطبيقات Google Chat وغير متاحة لإضافات Google Workspace.

OpenLink

ويمثِّل هذا الحدث حدث onClick يفتح رابطًا تشعّبيًا.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

الحقول

الحقول
`url`	`string` عنوان URL المطلوب فتحه.
`openAs`	`OpenAs` كيفية فتح رابط تتوفّر هذه الميزة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat.
`onClose`	`OnClose` تحديد ما إذا كان العميل قد نسي الرابط بعد فتحه أو لاحظه إلى أن يتم إغلاق النافذة. متاحة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat.

url

string

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

openAs

OpenAs

كيفية فتح رابط

تتوفّر هذه الميزة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat.

onClose

OnClose

تحديد ما إذا كان العميل قد نسي الرابط بعد فتحه أو لاحظه إلى أن يتم إغلاق النافذة.

متاحة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat.

OnClose

ما يفعله العميل عند إغلاق رابط مفتوح من خلال إجراء OnClick

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

في حال ضبط كلا المعالِجَين OnOpen وOnClose، ولم تتمكّن منصة البرنامج من استخدام كلتا القيمتَين، تكون الأولوية لـ OnClose.

متاحة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat.

عمليات التعداد

NOTHING القيمة التلقائية. لا تتم إعادة تحميل البطاقة، ولا يحدث شيء.

عمليات التعداد
`NOTHING`	القيمة التلقائية. لا تتم إعادة تحميل البطاقة، ولا يحدث شيء.
`RELOAD`	تُعيد تحميل البطاقة بعد إغلاق نافذة الطفل. في حال استخدام النافذة الفرعية مع `OpenAs.OVERLAY`، تعمل النافذة الفرعية كمربّع حوار مشروط ويتم حظر البطاقة الرئيسية إلى أن يتم إغلاق النافذة الفرعية.

RELOAD

تُعيد تحميل البطاقة بعد إغلاق نافذة الطفل.

في حال استخدام النافذة الفرعية مع OpenAs.OVERLAY، تعمل النافذة الفرعية كمربّع حوار مشروط ويتم حظر البطاقة الرئيسية إلى أن يتم إغلاق النافذة الفرعية.

OpenAs

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

تتوفّر هذه الميزة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat.

عمليات التعداد
`FULL_SIZE`	يتم فتح الرابط كنافذة بالحجم الكامل (إذا كان هذا هو الإطار الذي يستخدمه العميل).
`OVERLAY`	يتم فتح الرابط على شكل عنصر متراكب، مثل نافذة منبثقة.

OverflowMenu

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

تتوفّر هذه الميزة لتطبيقات Google Chat ولا تتوفّر لإضافات Google Workspace.

الحقول

items[]

OverflowMenuItem

مطلوب. قائمة خيارات القائمة.

OverflowMenuItem

خيار يمكن للمستخدمين تنفيذه في قائمة الخيارات الإضافية

تتوفّر هذه الميزة لتطبيقات Google Chat ولا تتوفّر لإضافات Google Workspace.

الحقول
`startIcon`	`Icon` الرمز المعروض أمام النص
`text`	`string` مطلوب. النص الذي يحدّد السلعة أو يصفّها للمستخدمين
`onClick`	`OnClick` مطلوب. تم تنفيذ الإجراء عند تحديد أحد خيارات القائمة. لا يمكن أن يحتوي `OnClick` هذا على `OverflowMenu`، ويتم إسقاط أي `OverflowMenu` محدّد ويتم إيقاف عنصر القائمة.
`disabled`	`bool` ما إذا كان خيار القائمة معطلاً أم لا. القيمة التلقائية هي false.

RenderActions

مجموعة من تعليمات العرض التي تُطلب من البطاقة تنفيذ إجراء معيّن، أو تُطلب من التطبيق المضيف للإضافة أو تطبيق Chat تنفيذ إجراء خاص بالتطبيق

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

الحقول

action

Action

hostAppAction

HostAppActionMarkup

تعالج تطبيقات مضيف فردية الإجراءات.

schema

string

وهذا حقل مخطّط مفتوح، قد يكون متوفّرًا في الترميز للتحقّق من البنية.

الإجراء

الحقول
`navigations[]`	`Navigation` دفع البطاقات المعروضة أو إظهارها أو تعديلها
`link`	`OpenLink` افتح الرابط الهدف على الفور في علامة تبويب أو نافذة منبثقة جديدة.
`notification`	`Notification` عرض إشعار للمستخدم النهائي
`linkPreview`	`LinkPreview` عرض معاينة الرابط للمستخدم النهائي
`links[]`	`Link` رابط لمرجع تابع لجهة خارجية تم إنشاؤه من داخل أحد تطبيقات Google Workspace يتم تنسيقها كمصفوفة من العناصر التي تحتوي على عنصر واحد. لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء موارد تابعة لجهات خارجية من قائمة "@".

SelectionInput

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

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

لجمع بيانات غير محدّدة أو مجردة من المستخدمين، استخدِم التطبيق المصغّر TextInput.

متاحة لتطبيقات Google Chat وإضافات Google Workspace.

الحقول
`name`	`string` مطلوب. الاسم الذي يحدّد إدخال الاختيار في حدث إدخال نموذج. لمعرفة تفاصيل عن التعامل مع إدخالات النماذج، يُرجى الاطّلاع على تلقي بيانات النموذج.
`label`	`string` النص الذي يظهر أعلى حقل إدخال التحديد في واجهة المستخدم حدِّد نصًا يساعد المستخدم في إدخال المعلومات التي يحتاجها تطبيقك. على سبيل المثال، إذا كان المستخدمون يختارون مدى إلحاح طلب العمل من قائمة منسدلة، قد يكون التصنيف "مدى إلحاح الطلب" أو "اختيار مدى إلحاح الطلب".
`type`	`SelectionType` نوع العناصر التي يتم عرضها للمستخدمين في تطبيق مصغّر `SelectionInput` تتيح أنواع الاختيارات أنواعًا مختلفة من التفاعلات. على سبيل المثال، يمكن للمستخدمين تحديد مربع اختيار واحد أو أكثر، ولكن يمكنهم فقط تحديد قيمة واحدة من قائمة منسدلة.
`items[]`	`SelectionItem` مصفوفة من العناصر القابلة للاختيار على سبيل المثال، مصفوفة من أزرار الاختيار أو مربّعات الاختيار يمكن استخدام ما يصل إلى 100 عنصر.
`onChangeAction`	`Action` إذا تم تحديد هذا الخيار، يتم إرسال النموذج عند تغيير الاختيار. وإذا لم يتم تحديده، يجب تحديد زر منفصل لإرسال النموذج. لمعرفة التفاصيل حول التعامل مع إدخالات النماذج، يُرجى الاطّلاع على تلقّي بيانات النماذج.
`multiSelectMaxSelectedItems`	`int32` بالنسبة إلى قوائم التحديد المتعدد، يكون الحد الأقصى لعدد العناصر التي يمكن للمستخدم اختيارها. الحد الأدنى للقيمة هو سلعة واحدة. وفي حال عدم تحديد قيمة، يتم ضبط الإعدادات التلقائية على 3 عناصر.
`multiSelectMinQueryLength`	`int32` بالنسبة إلى قوائم التحديد المتعدد، يتم الإكمال التلقائي لعدد الأحرف النصية التي يُدخلها المستخدم قبل طلب بحث التطبيق ويعرض العناصر المقترحة في القائمة. إذا لم يتم تحديدها، يتم ضبطها تلقائيًا على 0 أحرف لمصادر البيانات الثابتة و3 أحرف لمصادر البيانات الخارجية.
`validation`	`Validation` بالنسبة إلى القوائم المنسدلة، ينطبق ذلك على عملية التحقّق من صحة حقل إدخال الاختيار هذا. متاحة لتطبيقات Google Chat وإضافات Google Workspace.
حقل الاتحاد `multi_select_data_source`. بالنسبة إلى قائمة الاختيار المتعدد، يكون مصدر البيانات الذي يملأ عناصر الاختيار. تتوفّر هذه الميزة لتطبيقات Google Chat ولا تتوفّر لإضافات Google Workspace. يمكن أن يكون `multi_select_data_source` واحدًا فقط مما يلي:
`externalDataSource`	`Action` مصدر بيانات خارجي، مثل قاعدة بيانات علائقية
`platformDataSource`	`PlatformDataSource` مصدر بيانات من Google Workspace.

PlatformDataSource

بالنسبة إلى تطبيق SelectionInput المصغّر الذي يستخدم قائمة اختيار متعددة، وهو مصدر بيانات من Google Workspace. تُستخدَم لتعبئة العناصر في قائمة متعددة الاختيارات.

متاحة لتطبيقات Google Chat وغير متاحة لإضافات Google Workspace.

الحقول

حقل الربط data_source مصدر البيانات يمكن أن يكون data_source واحدًا فقط مما يلي:

commonDataSource

CommonDataSource

مصدر بيانات تشاركه جميع تطبيقات Google Workspace، مثل المستخدمين في مؤسسة Google Workspace.

hostAppDataSource

HostAppDataSourceMarkup

مصدر بيانات فريد لتطبيق مضيف Google Workspace، مثل المساحات في Google Chat.

يتوافق هذا الحقل مع مكتبات Google API Client Libraries، ولكنّه غير متوفّر في مكتبات Cloud Client Libraries. لمزيد من المعلومات، يُرجى الاطّلاع على تثبيت مكتبات العملاء.

CommonDataSource

مصدر بيانات تتم مشاركته من خلال جميع تطبيقات Google Workspace

تتوفّر هذه الميزة لتطبيقات Google Chat ولا تتوفّر لإضافات Google Workspace.

عمليات التعداد
`UNKNOWN`	القيمة التلقائية لا تستخدِم هذه الميزة.
`USER`	مستخدمو Google Workspace يمكن للمستخدم الاطّلاع على المستخدمين واختيارهم من مؤسسة Google Workspace فقط.

SelectionItem

يشير ذلك المصطلح إلى عنصر يمكن للمستخدمين اختياره في حقل إدخال محدَّد، مثل مربّع اختيار أو مفتاح تبديل.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

الحقول
`text`	`string` النص الذي يعرّف المستخدمين على السلعة أو يصفها
`value`	`string` القيمة المرتبطة بهذا العنصر على العميل استخدام هذا الرمز كقيمة إدخال نموذج. لمعرفة التفاصيل حول التعامل مع إدخالات النماذج، يُرجى الاطّلاع على تلقّي بيانات النماذج.
`selected`	`bool` يوضّح ما إذا كان العنصر محدّدًا تلقائيًا. إذا كان حقل الإدخال للاختيار يقبل قيمة واحدة فقط (مثل أزرار الاختيار أو القائمة المنسدلة)، اضبط هذا الحقل لعنصر واحد فقط.
`startIconUri`	`string` بالنسبة إلى القوائم التي تتيح الاختيار المتعدّد، يشير هذا الحقل إلى عنوان URL للرمز المعروض بجانب حقل `text` الخاص بالعنصر. يمكن استخدام الملفات بتنسيق PNG وJPEG. يجب أن يكون عنوان URL `HTTPS`. مثلاً: `https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png`
`bottomText`	`string` بالنسبة إلى قوائم الاختيار المتعدّد، يشير ذلك إلى وصف نصي أو تصنيف يتم عرضه أسفل حقل `text` للعنصر.

SelectionType

تنسيق العناصر التي يمكن للمستخدمين اختيارها تتيح الخيارات المختلفة أنواعًا مختلفة من التفاعلات. على سبيل المثال، يمكن للمستخدمين تحديد عدة مربعات اختيار، ولكن يمكنهم فقط تحديد عنصر واحد من القائمة المنسدلة.

يتيح كل إدخال اختيار نوعًا واحدًا من الاختيارات. على سبيل المثال، لا يمكن استخدام مربّعات الاختيار ومفاتيح التبديل معًا.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

عمليات التعداد
`CHECK_BOX`	مجموعة من مربعات الاختيار. يمكن للمستخدمين اختيار مربّع اختيار واحد أو أكثر.
`RADIO_BUTTON`	مجموعة من أزرار الاختيار يمكن للمستخدمين اختيار زر اختيار واحد.
`SWITCH`	مجموعة من مفاتيح التبديل يمكن للمستخدمين تفعيل مفتاح تحكّم واحد أو أكثر.
`DROPDOWN`	قائمة منسدلة يمكن للمستخدمين اختيار عنصر واحد من القائمة.
`MULTI_SELECT`	قائمة اختيار متعدّد للبيانات الثابتة أو الديناميكية من شريط القوائم، يختار المستخدمون عنصرًا واحدًا أو أكثر. يمكن للمستخدمين أيضًا إدخال قيم لتعبئة البيانات الديناميكية. على سبيل المثال، يمكن للمستخدمين بدء كتابة اسم مساحة في Google Chat، ويقترح التطبيق المصغّر المساحة تلقائيًا. لتعبئة العناصر لقائمة اختيار متعدّد، يمكنك استخدام أحد الأنواع التالية من مصادر البيانات: البيانات الثابتة: يتم تحديد العناصر كعناصر `SelectionItem` في التطبيق المصغّر. يمكنك الاستفادة من ما يصل إلى 100 عنصر. بيانات Google Workspace: تتم تعبئة العناصر باستخدام بيانات من Google Workspace، مثل مستخدمي Google Workspace أو مساحات Google Chat. البيانات الخارجية: يتمّ تعبئة العناصر من مصدر بيانات خارجي خارج Google Workspace. للحصول على أمثلة عن كيفية تنفيذ قوائم الاختيار المتعدّد، اطّلِع على إضافة قائمة اختيار متعدّد. تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

SubmitFormResponse

ردّ على إرسال نموذج بخلاف الحصول على حاوية الإكمال التلقائي التي تحتوي على الإجراءات التي يجب أن تنفّذها البطاقة و/أو تطبيق مضيف الإضافة وما إذا كانت حالة البطاقة قد تغيّرت

متاحة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat. على سبيل المثال:

{
  "renderActions": {
    "action": {
      "notification": {
        "text": "Email address is added: [email protected]"
      }
    },
    "hostAppAction": {
      "gmailAction": {
        "openCreatedDraftAction": {
          "draftId": "msg-a:r-79766936926021702",
          "threadServerPermId": "thread-f:15700999851086004"
        }
      }
    }
  }
}

الحقول

renderActions

RenderActions

مجموعة من تعليمات العرض التي تُطلب من البطاقة تنفيذ إجراء و/أو تُطلب من التطبيق المضيف للإضافة تنفيذ إجراء خاص بالتطبيق

stateChanged

bool

ما إذا كانت حالة البطاقات قد تغيّرت والبيانات في البطاقات الحالية قديمة

schema

string

هذا حقل مخطّط مفتوح، قد يكون متوفّرًا في الترميز للتحقّق من البنية.

اقتراحات

القيم المقترَحة التي يمكن للمستخدمين إدخالها تظهر هذه القيم عندما ينقر المستخدمون داخل حقل إدخال النص. أثناء كتابة المستخدمين، تتم تصفية القيم المقترَحة ديناميكيًا لمطابقة ما كتبه المستخدمون.

على سبيل المثال، قد يقترح حقل إدخال نص للغة البرمجة Java وJavaScript وPython وC++. وعندما يبدأ المستخدمون في كتابة Jav، ستظهر قائمة فلاتر الاقتراحات لعرض Java وJavaScript.

تساعد القيم المقترَحة المستخدمين في إدخال قيم يمكن لتطبيقك فهمها. عند الإشارة إلى JavaScript، قد يُدخِل بعض المستخدمين javascript والبعض الآخر java script. يمكن أن يؤدي اقتراح "JavaScript" إلى توحيد طريقة تفاعل المستخدمين مع تطبيقك.

عند تحديده، يكون TextInput.type دائمًا SINGLE_LINE، حتى إذا تم ضبطه على MULTIPLE_LINE.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

الحقول

items[]

SuggestionItem

قائمة بالاقتراحات المستخدَمة لاقتراحات الإكمال التلقائي في حقول إدخال النصوص

SuggestionItem

قيمة مقترَحة يمكن للمستخدمين إدخالها في حقل إدخال نص.

متاحة لتطبيقات Google Chat وإضافات Google Workspace.

الحقول

حقل الربط content

يمكن أن يكون content واحدًا فقط مما يلي:

text

string

قيمة الإدخال المقترَح في حقل إدخال نص. وهذا يعادل ما يدخله المستخدمون بأنفسهم.

TextInput

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

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

استخدِم حقل إدخال نصيًا عندما تحتاج إلى جمع بيانات غير محدّدة أو مجردة من المستخدمين. لجمع بيانات محدّدة أو معدّة من المستخدمين، استخدِم تطبيق "SelectionInput" المصغّر.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

الحقول
`name`	`string` الاسم الذي يتم من خلاله التعرّف على إدخال النص في حدث إدخال نموذج. لمعرفة تفاصيل عن التعامل مع إدخالات النماذج، يُرجى الاطّلاع على تلقي بيانات النموذج.
`label`	`string` النص الذي يظهر أعلى حقل إدخال النص في واجهة المستخدم حدِّد نصًا يساعد المستخدم في إدخال المعلومات التي يحتاجها تطبيقك. على سبيل المثال، إذا كنت تسأل عن اسم أحد الأشخاص، ولكنك تحتاج إلى اسم العائلة على وجه التحديد، اكتب `surname` بدلاً من `name`. مطلوبة إذا لم يتم تحديد `hintText`. وبخلاف ذلك، اختياري.
`hintText`	`string` النص الذي يظهر أسفل حقل إدخال النص والمخصّص لمساعدة المستخدمين من خلال مطالبتهم بإدخال قيمة معيّنة ويكون هذا النص مرئيًا دائمًا. مطلوبة إذا لم يتم تحديد `label`. وبخلاف ذلك، اختياري.
`value`	`string` القيمة التي أدخلها المستخدِم، ويتم عرضها كجزء من حدث إدخال نموذج. لمعرفة تفاصيل عن التعامل مع إدخالات النماذج، يُرجى الاطّلاع على تلقي بيانات النموذج.
`type`	`Type` طريقة ظهور حقل إدخال نص في واجهة المستخدم على سبيل المثال، ما إذا كان الحقل سطرًا واحدًا أو عدّة أسطر.
`onChangeAction`	`Action` الإجراءات التي يجب اتّخاذها عند حدوث تغيير في حقل إدخال النص على سبيل المثال، إضافة مستخدم إلى الحقل أو حذف نص. تشمل أمثلة الإجراءات التي يجب اتّخاذها تنفيذ وظيفة مخصّصة أو فتح مربّع حوار في Google Chat.
`initialSuggestions`	`Suggestions` القيم المقترَحة التي يمكن للمستخدمين إدخالها. تظهر هذه القيم عندما ينقر المستخدمون داخل حقل إدخال النص. أثناء كتابة المستخدمين، تتم تصفية القيم المقترَحة ديناميكيًا لمطابقة ما كتبه المستخدمون. على سبيل المثال، قد يقترح حقل إدخال نص للغة البرمجة Java وJavaScript وPython وC++. وعندما يبدأ المستخدمون في كتابة `Jav`، ستظهر قائمة بفلاتر الاقتراحات لعرض `Java` و`JavaScript` فقط. تساعد القيم المقترَحة المستخدمين في إدخال قيم يمكن لتطبيقك فهمها. عند الإشارة إلى JavaScript، قد يُدخل بعض المستخدمين `javascript` والبعض الآخر يدخل `java script`. يمكن أن يؤدي اقتراح `JavaScript` إلى توحيد كيفية تفاعل المستخدمين مع تطبيقك. عند تحديده، يكون `TextInput.type` دائمًا `SINGLE_LINE`، حتى إذا تم ضبطه على `MULTIPLE_LINE`. متاحة لتطبيقات Google Chat وإضافات Google Workspace.
`autoCompleteAction`	`Action` اختياريّ. حدِّد الإجراء الذي يجب اتخاذه عندما يقدّم حقل إدخال النص اقتراحات للمستخدمين الذين يتفاعلون معه. إذا لم يتم تحديدها، يتم ضبط الاقتراحات بواسطة `initialSuggestions` ويعالجها العميل. يتّخذ التطبيق الإجراء المحدّد هنا، مثل تشغيل دالة مخصّصة، إذا تم تحديده. تتوفّر هذه الميزة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat.
`validation`	`Validation` معاينة المطوِّر: متاحة في إطار برنامج معاينة المطوّر على Google Workspace الذي يمنح إمكانية استخدام ميزات معيّنة قبل إطلاقها. حدِّد عملية التحقّق اللازمة لحقل إدخال النص هذا. تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.
`placeholderText`	`string` النص الذي يظهر في حقل إدخال النص عندما يكون الحقل فارغًا استخدِم هذا النص لطلب إدخال قيمة من المستخدمين. مثلاً: `Enter a number from 0 to 100` متاحة لتطبيقات Google Chat وغير متاحة لإضافات Google Workspace.

النوع

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

متاحة لتطبيقات Google Chat وإضافات Google Workspace.

عمليات التعداد
`SINGLE_LINE`	حقل إدخال النص له ارتفاع ثابت لسطر واحد.
`MULTIPLE_LINE`	يحتوي حقل إدخال النص على ارتفاع ثابت لعدة أسطر.

TextParagraph

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

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

الحقول

text

string

النص الذي يظهر في التطبيق المصغّر.

maxLines

int32

الحد الأقصى لعدد أسطر النص المعروضة في الأداة. إذا كان النص يتجاوز الحد الأقصى المحدّد لعدد الأسطر، يتم إخفاء المحتوى الزائد خلف زر عرض المزيد. إذا كان النص مساويًا للحد الأقصى المحدَّد لعدد الأسطر أو أقصر منه، لن يظهر الزر عرض المزيد.

القيمة التلقائية هي 0، وفي هذه الحالة يتم عرض كل السياق. ويتم تجاهل القيم السلبية. تتوفّر هذه الميزة لتطبيقات Google Chat ولا تتوفّر لإضافات Google Workspace.

التحقّق من الصحة

تمثّل البيانات اللازمة للتحقّق من صحة التطبيق المصغّر المُرفَق بها.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

الحقول

characterLimit

int32

حدِّد عدد الأحرف المسموح به في التطبيقات المصغّرة لإدخال النصوص. تجدر الإشارة إلى أنّه لا يتم استخدام هذا الخيار إلا لإدخال النص ويتم تجاهله في التطبيقات المصغّرة الأخرى.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

inputType

InputType

حدد نوع أدوات الإدخال.

متاحة لتطبيقات Google Chat وإضافات Google Workspace.

InputType

نوع التطبيق المصغّر للإدخال

عمليات التعداد
`INPUT_TYPE_UNSPECIFIED`	نوع غير محدّد لا تستخدِم هذه الطريقة.
`TEXT`	نص عادي يقبل جميع الأحرف
`INTEGER`	قيمة عدد صحيح.
`FLOAT`	قيمة عائمة
`EMAIL`	عنوان بريد إلكتروني.
`EMOJI_PICKER`	رمز تعبيري تم اختياره من أداة اختيار الرموز التعبيرية التي يوفّرها النظام.

الحقول
`horizontalAlignment`	`HorizontalAlignment` تحدد ما إذا كان يجب محاذاة التطبيقات المصغّرة على يمين أو يسار أو وسط عمود.
حقل الربط `data` يمكن أن يحتوي التطبيق المصغّر على عنصر واحد فقط من العناصر التالية. يمكنك استخدام حقول تطبيقات مصغّرة متعددة لعرض المزيد من العناصر. يمكن أن يكون `data` واحدًا فقط مما يلي:
`textParagraph`	`TextParagraph` عرض فقرة نصية دعم نص بسيط بتنسيق HTML. لمزيد من المعلومات عن تنسيق النص، يُرجى الاطّلاع على المقالتَين تنسيق النص في تطبيقات Google Chat وتنسيق النص في إضافات Google Workspace. على سبيل المثال، ينشئ ملف JSON التالي نصًا بخط غامق: `"textParagraph": { "text": " <b>bold text</b>" }`
`image`	`Image` لعرض صورة على سبيل المثال، ينشئ ملف JSON التالي صورة تتضمّن نصًا بديلاً: `"image": { "imageUrl": "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png", "altText": "Chat app avatar" }`
`decoratedText`	`DecoratedText` تعرِض هذه السمة عنصرًا نصيًا مزخرفًا. على سبيل المثال، ينشئ ملف JSON التالي تطبيقًا مصغّرًا للنص المزخرف يعرض عنوان البريد الإلكتروني: `"decoratedText": { "icon": { "knownIcon": "EMAIL" }, "topLabel": "Email Address", "text": "[email protected]", "bottomLabel": "This is a new Email address!", "switchControl": { "name": "has_send_welcome_email_to_sasha", "selected": false, "controlType": "CHECKBOX" } }`
`buttonList`	`ButtonList` قائمة بالأزرار على سبيل المثال، ينشئ JSON التالي زرَّين. الأول هو زر نصي أزرق والثاني هو زر صورة يفتح رابطًا: `"buttonList": { "buttons": [ { "text": "Edit", "color": { "red": 0, "green": 0, "blue": 1, }, "disabled": true, }, { "icon": { "knownIcon": "INVITE", "altText": "check calendar" }, "onClick": { "openLink": { "url": "https://example.com/calendar" } } } ] }`
`textInput`	`TextInput` تعرِض هذه السمة مربّع نص يمكن للمستخدمين الكتابة فيه. على سبيل المثال، ينشئ ملف JSON التالي إدخال نص لعنوان بريد إلكتروني: `"textInput": { "name": "mailing_address", "label": "Mailing Address" }` كمثال آخر، ينشئ JSON التالي إدخالاً نصيًا للغة برمجة يحتوي على اقتراحات ثابتة: `"textInput": { "name": "preferred_programing_language", "label": "Preferred Language", "initialSuggestions": { "items": [ { "text": "C++" }, { "text": "Java" }, { "text": "JavaScript" }, { "text": "Python" } ] } }`
`selectionInput`	`SelectionInput` تعرِض عنصر تحكّم في الاختيار يتيح للمستخدمين اختيار العناصر. يمكن أن تكون عناصر التحكم في التحديد مربعات اختيار أو أزرار اختيار أو مفاتيح تبديل أو قوائم منسدلة. على سبيل المثال، ينشئ ملف JSON التالي قائمة منسدلة تتيح للمستخدمين اختيار حجم: `"selectionInput": { "name": "size", "label": "Size" "type": "DROPDOWN", "items": [ { "text": "S", "value": "small", "selected": false }, { "text": "M", "value": "medium", "selected": true }, { "text": "L", "value": "large", "selected": false }, { "text": "XL", "value": "extra_large", "selected": false } ] }`
`dateTimePicker`	`DateTimePicker` تعرِض هذه السمة تطبيقًا مصغّرًا يتيح للمستخدمين إدخال تاريخ أو وقت أو تاريخ ووقت. على سبيل المثال، ينشئ ملف JSON التالي أداة اختيار التاريخ والوقت لجدولة موعد: `"dateTimePicker": { "name": "appointment_time", "label": "Book your appointment at:", "type": "DATE_AND_TIME", "valueMsEpoch": "796435200000" }`
`divider`	`Divider` تعرِض هذه السمة خطًا أفقيًا بين التطبيقات المصغّرة. على سبيل المثال، ينشئ JSON التالي فاصلاً: `"divider": { }`
`grid`	`Grid` تعرض شبكة بها مجموعة من العناصر. تدعم الشبكة أي عدد من الأعمدة والعناصر. يتم تحديد عدد الصفوف من خلال الحدود العليا لعدد السلع مقسومًا على عدد الأعمدة. تحتوي الشبكة التي تتضمّن 10 عناصر وعمودَين على 5 صفوف. الشبكة التي تتكون من 11 عنصرًا وعمودين بها 6 صفوف. متاحة لتطبيقات Google Chat وإضافات Google Workspace. على سبيل المثال، ينشئ تنسيق JSON التالي شبكة من عمودَين تحتوي على عنصر واحد: `"grid": { "title": "A fine collection of items", "columnCount": 2, "borderStyle": { "type": "STROKE", "cornerRadius": 4 }, "items": [ { "image": { "imageUri": "https://www.example.com/image.png", "cropStyle": { "type": "SQUARE" }, "borderStyle": { "type": "STROKE" } }, "title": "An item", "textAlignment": "CENTER" } ], "onClick": { "openLink": { "url": "https://www.example.com" } } }`
`columns`	`Columns` يتم عرض ما يصل إلى عمودَين. لتضمين أكثر من عمودَين أو لاستخدام الصفوف، استخدِم التطبيق المصغّر `Grid`. على سبيل المثال، ينشئ ملف JSON التالي عمودَين يحتوي كل منهما على فقرات نصية: `"columns": { "columnItems": [ { "horizontalSizeStyle": "FILL_AVAILABLE_SPACE", "horizontalAlignment": "CENTER", "verticalAlignment": "CENTER", "widgets": [ { "textParagraph": { "text": "First column text paragraph" } } ] }, { "horizontalSizeStyle": "FILL_AVAILABLE_SPACE", "horizontalAlignment": "CENTER", "verticalAlignment": "CENTER", "widgets": [ { "textParagraph": { "text": "Second column text paragraph" } } ] } ] }`
`chipList`	`ChipList` قائمة بشرائح على سبيل المثال، ينشئ JSON التالي شريحتَين. الأول هو شريحة نصية والثاني هو شريحة رمز تفتح رابطًا: `"chipList": { "chips": [ { "text": "Edit", "disabled": true, }, { "icon": { "knownIcon": "INVITE", "altText": "check calendar" }, "onClick": { "openLink": { "url": "https://example.com/calendar" } } } ] }` تتوفّر هذه الميزة لتطبيقات Google Chat ولا تتوفّر لإضافات Google Workspace.

HorizontalAlignment

عمليات التعداد
`HORIZONTAL_ALIGNMENT_UNSPECIFIED`	لا تستخدِم هذه الميزة. غير محدد
`START`	القيمة التلقائية. لمحاذاة الأدوات مع موضع بداية العمود. بالنسبة للتخطيطات من اليسار إلى اليمين، تتم المحاذاة إلى اليسار. بالنسبة إلى التنسيقات من اليمين إلى اليسار، يتمّ محاذاة النص على اليسار.
`CENTER`	لمحاذاة الأدوات في وسط العمود.
`END`	لمحاذاة الأدوات مع موضع نهاية العمود. بالنسبة إلى التنسيقات من اليسار إلى اليمين، يتم محاذاة التطبيقات المصغّرة على اليمين. بالنسبة إلى التنسيقات من اليمين إلى اليسار، يتم محاذاة التطبيقات المصغّرة على اليسار.

ImageType

عمليات التعداد
`SQUARE`	القيمة التلقائية يتم تطبيق قناع مربّع على الصورة. على سبيل المثال، تصبح الصورة التي تبلغ نسبة عرضها إلى ارتفاعها 4×3 بنسبة 3×3.
`CIRCLE`	يطبّق قناعًا دائريًا على الصورة. على سبيل المثال، تصبح صورة 4×3 دائرة بقطر 3.

Package google.apps.card.v1

الفهرس

الإجراء

ActionParameter

التفاعل

LoadIndicator

BorderStyle

BorderType

زرّ

النوع

ButtonList

بطاقة

CardAction

CardFixedFooter

CardHeader

DisplayStyle

DividerStyle

القسم

شريحة

ChipList

التنسيق

CollapseControl

الأعمدة

العمود

HorizontalSizeStyle

VerticalAlignment

التطبيقات المصغَّرة

DateTimePicker

DateTimePickerType

DecoratedText

عنصر تحكم التبديل

ControlType

حاجز

EndNavigation

الإجراء

GetAutocompletionResponse

شبكة

GridItem

GridItemLayout

الرمز

صورة

ImageComponent

ImageCropStyle

ImageCropType

رابط

LinkPreview

MaterialIcon

التنقّل

إشعار

OnClick

OpenLink

OnClose

OpenAs

OverflowMenu

OverflowMenuItem

RenderActions

الإجراء

SelectionInput

PlatformDataSource

CommonDataSource

SelectionItem

SelectionType

SubmitFormResponse

اقتراحات

SuggestionItem

TextInput

النوع

TextParagraph

التحقّق من الصحة

InputType

أداة

HorizontalAlignment

ImageType