این صفحه نحوه طراحی و ایجاد اجزای اصلی رابط کاربری پیامهای کارت در Google Chat را شرح میدهد.
کارتها از طرحبندی تعریفشده، عناصر رابط کاربری تعاملی، مانند دکمهها، و رسانههای غنی مانند تصاویر پشتیبانی میکنند. میتوانید از کارتها برای ارائه اطلاعات، جمعآوری ورودی یا ارائه مراحل بعدی به کاربران از طریق پیامها و گفتگوهای کارت استفاده کنید.
از Card Builder برای طراحی و پیش نمایش پیام های کارت JSON برای برنامه های Chat استفاده کنید:
کارت ساز را باز کنیدکارت ها و دیالوگ ها به طور کلی دارای اجزای زیر هستند:
- یک
CardHeader
که حاوی عنوان کارت شما است. - یک یا چند ویجت
CardSection
که بدنه اصلی کارت را تشکیل می دهند. - ویجت
CardFixedFooter
که فقط برای دیالوگ ها اختصاص دارد.
پیش نیازها
یک برنامه Google Chat که برای ویژگیهای تعاملی فعال است. برای ایجاد یک برنامه چت تعاملی، یکی از شروع سریع زیر را بر اساس معماری برنامه ای که می خواهید استفاده کنید، انجام دهید:
- سرویس HTTP با توابع Google Cloud
- اسکریپت Google Apps
- Google Cloud Dialogflow CX
- Google Cloud Pub/Sub
یک هدر اضافه کنید
ویجت CardHeader
نشان دهنده هدر یک کارت است. هدرها می توانند شامل عنوان، زیرنویس و تصویر آواتار برای کارت شما باشند.
میتوانید CardHeader
برای پیامها و گفتگوهای کارت اضافه کنید.
نمونه زیر یک نمونه از CardHeader
است:
قسمتی از کارت را تعریف کنید
ویجت CardSection
یک ظرف سطح بالا در کارت است. شما از بخش های کارت برای گروه بندی ویجت ها در کارت استفاده می کنید. برای هر بخش کارت، می توانید یک هدر و یک یا چند ویجت اضافه کنید.
میتوانید CardSection
برای پیامها و گفتگوهای کارت اضافه کنید.
نمونه زیر نمونه ای از CardSection
است که شامل دو ویجت textParagraph
است:
دکمه کنترل قابل تنظیم بخش تاشو
دکمه کنترلی را که بخشهای کارتهای گپ را جمع میکند و گسترش میدهد، سفارشی کنید. از میان طیف وسیعی از نمادها یا تصاویر برای نمایش بصری محتوای بخش انتخاب کنید و درک و تعامل با اطلاعات را برای کاربران آسانتر میکند.
یک پاورقی ماندگار اضافه کنید
ویجت CardFixedFooter
نشان دهنده پاورقی یک پیام محاوره ای است که توسط یک برنامه چت ارسال می شود. پاورقی ها می توانند شامل یک دکمه اصلی و یک دکمه ثانویه باشند.
ویجت CardFixedFooter
فقط برای گفتگوها در دسترس است.
نمونه زیر یک ویجت CardFixedFooter
با دو دکمه است:
عیب یابی
وقتی یک برنامه یا کارت Google Chat خطایی را برمیگرداند، رابط Chat پیامی را نشان میدهد که میگوید «مشکلی پیش آمده است». یا "نمی توان به درخواست شما رسیدگی کرد." گاهی اوقات Chat UI هیچ پیام خطایی را نمایش نمی دهد، اما برنامه یا کارت Chat نتیجه غیرمنتظره ای ایجاد می کند. برای مثال، ممکن است پیام کارت ظاهر نشود.
اگرچه ممکن است پیام خطا در رابط کاربری گپ نمایش داده نشود، پیامهای خطای توصیفی و دادههای گزارش در دسترس هستند تا به شما کمک کنند هنگام فعال بودن ثبت خطا برای برنامههای گپ، خطاها را برطرف کنید. برای راهنمایی برای مشاهده، اشکالزدایی و رفع خطاها، به عیبیابی و رفع خطاهای Google Chat مراجعه کنید.