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

Google Chat به شما امکان می دهد قالب بندی را به پیام ها اضافه کنید، از جمله موارد زیر:

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

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 برای طراحی و پیش نمایش پیام های کارت JSON برای برنامه های Chat استفاده کنید:

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

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

قالب مثال نتیجه ارائه شده
پررنگ "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 از عنصر icon استفاده شده برای تعیین یکی از نمادهای داخلی موجود در Chat پشتیبانی می‌کنند.

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

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

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

یک نماد Google Material Design به کارت اضافه کنید

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

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

یک نماد سفارشی به کارت اضافه کنید

ویجت‌های DecoratedText و ButtonList به شما امکان می‌دهند از نمادهای داخلی استفاده کنید یا نمادهای دلخواه خود را تعریف کنید. برای افزودن یک نماد سفارشی به کارت، فیلد iconUrl را وارد کرده و URL مربوط به نماد را مشخص کنید.

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