اجزای یک کارت یا دیالوگ را طراحی کنید

این صفحه نحوه طراحی و ایجاد اجزای اصلی رابط کاربری پیام‌های کارت در Google Chat را شرح می‌دهد.

کارت‌ها از طرح‌بندی تعریف‌شده، عناصر رابط کاربری تعاملی، مانند دکمه‌ها، و رسانه‌های غنی مانند تصاویر پشتیبانی می‌کنند. می‌توانید از کارت‌ها برای ارائه اطلاعات، جمع‌آوری ورودی یا ارائه مراحل بعدی به کاربران از طریق پیام‌ها و گفتگوهای کارت استفاده کنید.

از Card Builder برای طراحی و پیش نمایش پیام های کارت JSON برای برنامه های Chat استفاده کنید:

کارت ساز را باز کنید

کارت ها و دیالوگ ها به طور کلی دارای اجزای زیر هستند:

  • یک CardHeader که حاوی عنوان کارت شما است.
  • یک یا چند ویجت CardSection که بدنه اصلی کارت را تشکیل می دهند.
  • ویجت CardFixedFooter که فقط برای دیالوگ ها اختصاص دارد.

پیش نیازها

  • یک حساب Google Workspace با دسترسی به Google Chat .
  • یک برنامه چت منتشر شده. برای ایجاد یک برنامه چت، این شروع سریع را دنبال کنید.

    • یک هدر اضافه کنید

    ویجت CardHeader نشان دهنده هدر یک کارت است. هدرها می توانند شامل عنوان، زیرنویس و تصویر آواتار برای کارت شما باشند.

    می‌توانید CardHeader برای پیام‌ها و گفتگوهای کارت اضافه کنید.

    نمونه زیر یک نمونه از CardHeader است:

    قسمتی از کارت را تعریف کنید

    ویجت CardSection یک ظرف سطح بالا در کارت است. شما از بخش های کارت برای گروه بندی ویجت ها در کارت استفاده می کنید. برای هر بخش کارت، می توانید یک هدر و یک یا چند ویجت اضافه کنید.

    می‌توانید CardSection برای پیام‌ها و گفتگوهای کارت اضافه کنید.

    نمونه زیر نمونه ای از CardSection است که شامل دو ویجت textParagraph است:

    ویجت CardFixedFooter نشان دهنده پاورقی یک پیام محاوره ای است که توسط یک برنامه چت ارسال می شود. پاورقی ها می توانند شامل یک دکمه اصلی و یک دکمه ثانویه باشند.

    ویجت CardFixedFooter فقط برای گفتگوها در دسترس است.

    نمونه زیر یک ویجت CardFixedFooter با دو دکمه است:

    عیب یابی

    وقتی یک برنامه یا کارت Google Chat خطایی را برمی‌گرداند، رابط Chat پیامی را نشان می‌دهد که می‌گوید «مشکلی پیش آمده است». یا "نمی توان به درخواست شما رسیدگی کرد." گاهی اوقات Chat UI هیچ پیام خطایی را نمایش نمی دهد، اما برنامه یا کارت Chat نتیجه غیرمنتظره ای ایجاد می کند. برای مثال، ممکن است پیام کارت ظاهر نشود.

    اگرچه ممکن است پیام خطا در رابط کاربری گپ نمایش داده نشود، پیام‌های خطای توصیفی و داده‌های گزارش در دسترس هستند تا به شما کمک کنند هنگام فعال بودن ثبت خطا برای برنامه‌های گپ، خطاها را برطرف کنید. برای راهنمایی برای مشاهده، اشکال‌زدایی و رفع خطاها، به عیب‌یابی و رفع خطاهای Google Chat مراجعه کنید.