قالب بندی پیام ها

این صفحه توضیح می‌دهد که چگونه برنامه‌های گپ Google می‌توانند متن را برای ارسال پیام‌هایی که حاوی هر یک از موارد زیر هستند، قالب‌بندی کنند:

  • متن غنی که حاوی لینک‌ها یا @ نام یک یا همه کاربران در فضای چت است.
  • متنی که در رابط کارت ظاهر می شود، از جمله به عنوان متن پاراگراف یا متن رابط کاربری که در کنار یک نماد نمایش داده می شود، مانند یک دکمه.

یک پیام متنی را قالب بندی کنید

Chat به شما امکان می دهد با استفاده از زیرمجموعه کوچکی از نحو Markdown، قالب بندی اولیه را به پیام متنی، از جمله پررنگ، مورب و خط خطی اضافه کنید. قالب بندی متن در پیام های متنی با پیام های کارت متفاوت است زیرا پیام های متنی با همان نحوی که کاربران چت استفاده می کنند قالب بندی می شوند.

برای قالب بندی پیام های متنی، از دستور زیر استفاده کنید:

قالب نماد نحو مثال متن نمایش داده شده در Google Chat
پررنگ * *سلام* سلام
کج _ (تاکید) _سلام_ سلام
ضربه زدن ~ ~سلام~ سلام
تک فضا ` (پشت نقل قول) "سلام". hello
بلوک تک فضایی ``` (سه نقل قول) ```
سلام
جهان
```		 Hello
World
لیست گلوله شده * یا - (فاصله) به دنبال آن یک فاصله

* این اولین مورد در لیست است

* این دومین مورد در لیست است

  • این اولین مورد در لیست است
  • این دومین مورد در لیست است

به عنوان مثال، JSON زیر را در نظر بگیرید:

    {
      "text": "Your pizza delivery *has arrived*!\nThank you for using _Cymbal Pizza!_"
    }

این پیام متنی فرمت شده موارد زیر را در فضای چت نمایش می دهد:

اپلیکیشن پیتزا سنبل پیامکی مبنی بر رسیدن تحویل ارسال می کند.

مشاهده قالب بندی متن ارسال شده در پیام

هنگامی که کاربر پیامی را ارسال می کند، متن ساده پیام در قسمت text قرار می گیرد. برخی از قالب‌بندی‌هایی که با استفاده از نحو Markdown روی پیام متنی اعمال می‌شود، در قسمت text است. قالب‌بندی اضافی در قسمت فقط خروجی formattedText است، از جمله موارد زیر:

  • دستور Markdown اضافی برای متن
  • اشاره های کاربر
  • هایپرلینک های سفارشی
  • ایموجی سفارشی

به عنوان مثال، متن زیر را که توسط یک کاربر ارسال شده است در نظر بگیرید:

پیام در چت با کلمه دریافت شد

اگر پیام با استفاده از منوی Format در Chat UI قالب‌بندی شده باشد، فیلد text فقط حاوی متن است، در حالی که قسمت formattedText حاوی نشانه‌گذاری‌ها، متن و لینک است. مثال زیر پیش نویس یک پیام متنی را با یک کلمه پیوند داده شده، موارد موجود در یک لیست و یک کلمه پررنگ نشان می دهد:

پیش نویس پیام با کلمه

پیام در قالب زیر دریافت می شود:

    {
      "text": "I can meet there at:\nNoon\n3 pm\n5 pm\nWhat time works for you?",
      "formattedText": "I can meet <http://example.com|there> at:\n* Noon\n* 3 pm\n* 5 pm\nWhat time works for *you*?",
    }

اگر یک URL پیوند ساده را در متن پیام خود وارد کنید، مانند http://www.example.com/ ، Google Chat از آن به عنوان متن پیوند استفاده می کند و به طور خودکار آن متن را به URL مشخص شده پیوند می دهد.

برای ارائه متن پیوند جایگزین برای پیوند خود، از نحو زیر استفاده کنید:

نحو مثال متن نمایش داده شده در Google Chat
<https://example.com|Example website>

متن لوله و پیوند اختیاری است، به طوری که <https://www.example.com/> و https://www.example.com/ معادل هستند.

نام کاربران در پیامک

برنامه‌های چت می‌توانند پیام‌های متنی ارسال کنند که @ نام یک یا همه کاربران را در فضای چت ذکر می‌کند. برنامه‌های گپ نمی‌توانند از کاربران در فضایی که در حالت واردات است یا کاربرانی که به فضا نپیوسته‌اند نام ببرند.

@منشن کاربران خاص

برای ذکر @ نام یک کاربر خاص، <users/{user}> را به پیام متنی اضافه کنید که {user} شناسه کاربر است. به عنوان مثال، پیام متنی زیر را در نظر بگیرید که در آن 123456789012345678901 نشان دهنده شناسه کاربر ماهان اس.

{
    "text": "A customer has reported an issue. Assigning ticket #942 to <users/123456789012345678901>."
}

پیام متنی به صورت زیر نمایش داده می شود:

برنامه چت از یک شخص در یک پیام متنی نام می برد.

می توانید مقدار users/{user} را به روش های زیر مشخص کنید:

  • اگر برنامه گپ Google شما به پیام ارسال شده توسط کاربر پاسخ می‌دهد، می‌توانید از قسمت message.sender.name رویداد تعامل MESSAGE استفاده کنید.

  • اگر برنامه Google Chat شما در حال ایجاد یک پیام متنی ناهمزمان است، می‌توانید مقدار را برای users/{user} به روش‌های زیر مشخص کنید:

    • از فیلد name منبع User چت Google، مانند users/123456789012345678901 استفاده کنید.
    • از آدرس ایمیل کاربر به عنوان نام مستعار برای مقدار {user} استفاده کنید. به عنوان مثال، اگر آدرس ایمیل mahan@example.com باشد، می توانید کاربر را به عنوان users/mahan@example.com مشخص کنید. برای استفاده از نام مستعار ایمیل، برنامه Google Chat شما باید به عنوان کاربر احراز هویت شود .

  • اگر از People API استفاده می کنید، می توانید از روش people.get نیز برای شناسایی شناسه کاربری استفاده کنید.

@منشن همه کاربران

برای ایجاد یک پیام متنی که @ از همه افراد در یک فضا نام می برد، {user} را با all جایگزین کنید. مثال JSON زیر همه کاربران را در یک پیام ذکر می کند:

{
    "text": "Important message for <users/all>: Code freeze starts at midnight tonight!"
}

متنی را که در کارت ها ظاهر می شود قالب بندی کنید

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

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

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

قالب بندی متن پاراگراف

تگ های پشتیبانی شده و هدف آنها در جدول زیر نشان داده شده است:

قالب مثال نتیجه ارائه شده
پررنگ "This is <b>bold</b>." این جسورانه است.
حروف کج "This is <i>italics</i>." این ایتالیک است.
زیر خط بکشید "This is <u>underline</u>." این زیر خط است.
ضربه زدن "This is <s>strikethrough</s>." این خط کشی است.
رنگ فونت "This is <font color=\"#FF0000\">red font</font>." این فونت قرمز است.
هایپرلینک "This is a <a href=\"https://www.google.com\">hyperlink</a>." این یک هایپرلینک است.
زمان "This is a time format: <time>2023-02-16 15:00</time>." این یک فرمت زمانی است: .
خط جدید "This is the first line. <br> This is a new line. " این خط اول است.
این یک خط جدید است.

اضافه کردن آیکون به متن

برای نمایش نمادها در کنار متن در کارت، می‌توانید از ویجت‌های DecoratedText و ButtonList استفاده کنید.

بخش‌های زیر نحوه استفاده از نمادهای داخلی، نمادهای Google Material یا نمادهای سفارشی را در متن یا دکمه‌های تزئین شده توضیح می‌دهند.

از نمادهای چت استفاده کنید

برای استفاده از نمادهای داخلی موجود در Chat، یکی از موارد زیر را مشخص کنید:

جدول زیر نمادهای داخلی موجود برای پیام های کارت را فهرست می کند:

هواپیما نشانک
اتوبوس ماشین
ساعت CONFIRMATION_NUMBER_ICON
توضیحات دلار
ایمیل EVENT_SEAT
FLIGHT_ARRIVAL FLIGHT_DEPARTURE
هتل HOTEL_ROOM_TYPE
دعوت کنید MAP_PIN
عضویت MULTIPLE_PEOPLE
PERSON تلفن
RESTAURANT_ICON SHOPPING_CART
ستاره فروشگاه
بلیط قطار
VIDEO_CAMERA VIDEO_PLAY

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

از نمادهای Google Material استفاده کنید

می توانید از نمادهای Google Material برای انتخاب از بین بیش از 2500 گزینه نماد و سفارشی کردن وزن، پر کردن و درجه نمادها استفاده کنید.

نمونه زیر یک نمونه کارت با نماد Google Material است:

از آیکون های سفارشی استفاده کنید

برای افزودن یک نماد سفارشی، فیلد iconUrl را وارد کرده و URL مربوط به نماد را مشخص کنید.

نمونه زیر نمونه ای از یک نماد سفارشی است: