این صفحه توضیح میدهد که چگونه برنامههای چت گوگل میتوانند متن را برای ارسال پیامهایی که شامل هر یک از موارد زیر هستند، قالببندی کنند:
- متن غنی که حاوی هایپرلینک یا @mention است و یک یا همه کاربران را در یک فضای چت منشن میکند.
- متنی که در رابط کاربری کارت ظاهر میشود، از جمله متن پاراگراف یا متن رابط کاربری که در کنار یک آیکون، مانند یک دکمه، نمایش داده میشود.
قالببندی یک پیام متنی
چت به شما امکان میدهد با استفاده از زیرمجموعه کوچکی از سینتکس Markdown، قالببندی اولیه، از جمله پررنگ، کج و خط خورده، را به یک پیام متنی اضافه کنید. قالببندی متن در پیامهای متنی با پیامهای کارتی متفاوت است، زیرا پیامهای متنی با همان سینتکسی که کاربران چت استفاده میکنند، قالببندی میشوند.
برای قالببندی پیامهای متنی، از سینتکس زیر استفاده کنید:
| قالب | نماد | مثال نحوی | متن نمایش داده شده در گوگل چت |
|---|---|---|---|
| پررنگ | * | *سلام* | سلام |
| ایتالیک | _ (زیرخط) | _سلام_ | سلام |
| خط خورده | ~ | ~سلام~ | |
| تکفضا | (نقل قول معکوس) | «سلام» | hello |
| بلوک تکفضا | `` ` (سه نقل قول) | ``` سلام جهان ``` | Hello |
| لیست گلولهای | * یا - (خط تیره) و به دنبال آن یک فاصله | * این اولین مورد در لیست است * این دومین مورد در لیست است |
|
| هایپرلینک | <hyperlink|display text> | <https://example.com|Example website> | برای کسب اطلاعات بیشتر در مورد هایپرلینک کردن، به بخش «قالببندی لینکها» مراجعه کنید. |
| کاربر را منشن کنید | <users/{user}> که در آن {user} شناسه کاربر است. | <users/123456789012345678901> | @ماهان س برای کسب اطلاعات بیشتر در مورد اشاره به کاربران، به «اشاره به کاربران در پیامک» مراجعه کنید. |
برای مثال، JSON زیر را در نظر بگیرید:
{
"text": "Your pizza delivery *has arrived*!\nThank you for using _Cymbal Pizza!_"
}
این پیام متنی قالببندیشده موارد زیر را در فضای چت نمایش میدهد:
مشاهده قالببندی متن ارسال شده در یک پیام
وقتی کاربری پیامی ارسال میکند، متن اصلی پیام در فیلد text قرار دارد. برخی از قالببندیهایی که با استفاده از سینتکس Markdown به پیام متنی اعمال میشوند، در فیلد text قرار دارند. قالببندیهای اضافی در فیلد formattedText فقط-خروجی قرار دارند، از جمله موارد زیر:
- سینتکس اضافی Markdown برای متن
- اشارههای کاربران
- هایپرلینکهای سفارشی
- ایموجیهای سفارشی
برای مثال، متن زیر را که توسط یک کاربر ارسال شده است در نظر بگیرید:
اگر پیام با استفاده از منوی Format در رابط کاربری چت قالببندی شده باشد، فیلد 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/ را در متن پیام خود قرار دهید، گوگل چت از آن به عنوان متن پیوند استفاده میکند و به طور خودکار آن متن را به آدرس اینترنتی مشخص شده پیوند میدهد.
برای ارائه متن پیوند جایگزین برای پیوند خود، از نحو زیر استفاده کنید:
| مثال نحوی | متن نمایش داده شده در گوگل چت |
|---|---|
<https://example.com|Example website> |
متن پایپ و لینک اختیاری است، بنابراین <https://www.example.com/> و https://www.example.com/ معادل هستند.
استفاده از ایموجیهای سفارشی در پیامک
برنامههای چت میتوانند برای شخصیسازی پیامها ، پیامهای متنی با ایموجیهای سفارشی ارسال کنند . ایموجیهای سفارشی فقط برای سازمانهای Google Workspace در دسترس هستند و مدیر باید ایموجیهای سفارشی را برای سازمان فعال کند. برای اطلاعات بیشتر، به «درباره ایموجیهای سفارشی در Google Chat بیشتر بدانید» و «مدیریت مجوزهای ایموجی سفارشی» مراجعه کنید.
برای ایجاد پیامهایی با ایموجیهای سفارشی، برنامه شما باید از احراز هویت کاربر استفاده کند. ایموجیهای سفارشی در پیامهایی که به عنوان وبهوک ایجاد میشوند یا در پیامهایی که با احراز هویت برنامه ایجاد میشوند، پشتیبانی نمیشوند.
برای افزودن ایموجی سفارشی به متن پیام، name یا emoji_name منبع customEmoji را مشخص کنید:
{
"text": "Hello <customEmojis/CUSTOM_EMOJI_ID>."
}
برای استفاده از این نمونه، CUSTOM_EMOJI_ID با شناسه ایموجی سفارشی جایگزین کنید. میتوانید این شناسه را در فیلد name یا emoji_name از منبع customEmoji پیدا کنید.
در یک پیامک از کاربران نام ببرید
برنامههای چت میتوانند پیامهای متنی ارسال کنند که یک یا همه کاربران را در یک فضای چت @mention کند. برنامههای چت همچنین میتوانند کاربرانی را که به فضا نپیوستهاند یا عضو فضایی هستند که در حالت import قرار دارد، منشن کنند.
@mention کاربران خاص
برای @mention کردن یک کاربر خاص، <users/{user}> را به پیام متنی اضافه کنید که در آن {user} شناسه کاربر است. برای مثال، پیام متنی زیر را در نظر بگیرید که در آن 123456789012345678901 نشان دهنده شناسه کاربر Mahan S. است:
{
"text": "A customer has reported an issue. Assigning ticket #942 to <users/123456789012345678901>."
}
متن پیام به صورت زیر نمایش داده میشود:
شما میتوانید مقدار users/{user} را به روشهای زیر مشخص کنید:
- اگر برنامه Google Chat شما به پیامی که توسط کاربر ارسال شده است پاسخ میدهد، میتوانید از فیلد
message.sender.nameدر رویداد تعاملMESSAGEاستفاده کنید. اگر برنامه Google Chat شما در حال ایجاد یک پیام متنی غیرهمزمان است، میتوانید مقدار را برای
users/{user}به روشهای زیر مشخص کنید:- از فیلد
nameمنبعUserچت گوگل، مانندusers/123456789012345678901استفاده کنید. - از آدرس ایمیل کاربر به عنوان نام مستعار برای مقدار
{user}استفاده کنید. برای مثال، اگر آدرس ایمیلmahan@example.comباشد، میتوانید کاربر را به صورتusers/mahan@example.comمشخص کنید. برای استفاده از نام مستعار ایمیل، برنامه Google Chat شما باید به عنوان یک کاربر احراز هویت شود .
- از فیلد
اگر از People API استفاده میکنید، میتوانید از متد
people.getنیز برای شناسایی شناسه کاربر استفاده کنید.
@ذکر کردن همه کاربران
برای ایجاد یک پیام متنی که همه کاربران داخل یک فاصله را با @mention منشن میکند، {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. » | این سطر اول است. این یک خط جدید است. |
برای تعریف لیستها و بلوکهای کد، از تگهای زیر استفاده کنید:
| قالب | مثال | نتیجه رندر شده |
|---|---|---|
| خط جدید | "Line 1<br>Line 2" | خط ۱ خط ۲ |
| تکفضا | "This is an <code>inline code</code>." | این یک inline code است. |
| بلوک تکفضا | "<pre><code>This a code block.</code></pre>" | |
| لیست گلولهای | "<ul><li>List item 1</li><li>List item 2</li></ul>" |
|
| لیست مرتب شده | "<ol><li>List item 1</li><li>List item 2</li></ol>" |
|
نشانهگذاری
وقتی سینتکس Markdown فعال باشد، میتوانید از سینتکس زیر استفاده کنید:
| قالب | مثال | نتیجه رندر شده |
|---|---|---|
| پررنگ | **سلام** یا __سلام__ | سلام |
| ایتالیک | *سلام* یا _درود_ | سلام |
| خط خورده | ~سلام~ | |
| تکفضا | «سلام» | hello |
| بلوک تکفضا | ``` سلام جهان ``` | Hello |
| لیست گلولهای | - این اولین مورد در لیست است - این دومین مورد در لیست است |
|
* این اولین مورد در لیست است * این دومین مورد در لیست است |
| |
| لیست مرتب شده | ۱. این اولین مورد در لیست است ۲. این دومین مورد در لیست است |
|
| هایپرلینک | [وبسایت نمونه](https://example.com) | نمونه وبسایت |
اضافه کردن آیکون به متن
برای نمایش آیکونها در کنار متن در یک کارت، میتوانید از ویجتهای DecoratedText و ButtonList استفاده کنید.
بخشهای بعدی نحوه استفاده از آیکونهای داخلی، آیکونهای Google Material یا آیکونهای سفارشی در متن یا دکمههای تزئینشده را توضیح میدهند.
استفاده از آیکونهای چت
برای استفاده از آیکونهای داخلی موجود در چت، یکی از موارد زیر را مشخص کنید:
جدول زیر نمادهای داخلی موجود برای پیامهای کارت را فهرست میکند:
| هواپیما | بوکمارک | ||
| اتوبوس | ماشین | ||
| ساعت | شماره_تایید_آیکون | ||
| شرح | دلار | ||
| ایمیل | صندلی رویداد | ||
| پرواز_رسیدن | پرواز_عزیمت | ||
| هتل | نوع_اتاق_هتل | ||
| دعوت | پین_نقشه | ||
| عضویت | چند_نفره | ||
| شخص | تلفن | ||
| آیکون رستوران | سبد خرید | ||
| ستاره | فروشگاه | ||
| بلیط | قطار | ||
| دوربین_فیلمبرداری | پخش ویدئو |
در زیر نمونهای از یک کارت با آیکون ایمیل را مشاهده میکنید:
از آیکونهای گوگل متریال استفاده کنید
شما میتوانید از آیکونهای گوگل متریال برای انتخاب از بین بیش از ۲۵۰۰ گزینه آیکون استفاده کنید و وزن، پر کردن و درجه آیکونها را سفارشی کنید.
در زیر نمونهای از کارت با آیکون Google Material را مشاهده میکنید:
استفاده از آیکونهای سفارشی
برای افزودن یک آیکون سفارشی، فیلد iconUrl را اضافه کنید و URL مربوط به آیکون را مشخص کنید.
نمونهای از یک آیکون سفارشی به صورت زیر است: