تصميم مكونات البطاقة أو مربع الحوار

توضح هذه الصفحة كيفية تصميم وإنشاء المكونات الرئيسية لواجهة المستخدم للبطاقة الرسائل في Google Chat

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

يمكنك استخدام "أداة إنشاء البطاقات" لتصميم رسائل بطاقات JSON ومعاينتها لتطبيقات Chat:

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

تحتوي البطاقات ومربّعات الحوار بشكل عام على العناصر التالية:

  • CardHeader الذي يتضمّن عنوان بطاقتك
  • تطبيق واحد أو أكثر من تطبيقات "CardSection" المصغّرة التي تشكِّل النص الأساسي للبطاقة
  • أداة CardFixedFooter مخصصة لمربعات الحوار فقط.

المتطلبات الأساسية

  • حساب Google Workspace مع إمكانية الوصول إلى Google Chat
  • تطبيق Chat منشور لإنشاء تطبيق Chat، اتّبِع الخطوات التالية التشغيل السريع:

    • إضافة عنوان

    تطبيق CardHeader المصغّر عنوان بطاقة. يمكن أن تتضمن العناوين العنوان والعنوان الفرعي والصورة الرمزية لبطاقتك.

    يمكنك تضمين CardHeader في بطاقات الرسائل مربعات الحوار.

    إليك مثال على السمة CardHeader:

    تحديد قسم في البطاقة

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

    يمكنك تضمين CardSection في بطاقات الرسائل مربعات الحوار.

    إليك مثال على السمة CardSection التي تتضمّن سمتين textParagraph التطبيقات المصغّرة:

    CardFixedFooter يمثل التطبيق تذييل رسالة مربع حوار تم إرساله بواسطة تطبيق Chat. يمكن أن تتضمن التذييلات زرًا أساسيًا وزرًا ثانويًا.

    لا يتوفّر التطبيق المصغّر "CardFixedFooter" إلا مربعات الحوار.

    في ما يلي مثال على أداة CardFixedFooter تتضمّن زرَّين:

    تحديد المشاكل وحلّها

    عند تثبيت تطبيق Google Chat أو تعرض card خطأً، تعرض واجهة Chat رسالة مفادها "حدث خطأ". أو "تعذَّرت معالجة طلبك". في بعض الأحيان، لا يمكن واجهة مستخدم Chat لا يعرض أي رسالة خطأ، ولكن يظهر تطبيق Chat أو ينتج عن بطاقة نتيجة غير متوقعة؛ على سبيل المثال، قد لا تظهر رسالة البطاقة موضع الإعلان.

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