تنسيق الرسائل

يتيح لك Google Chat إضافة تنسيق إلى الرسائل، بما في ذلك ما يلي:

• يكون التنسيق الأساسي للنص، مثل الخط الغامق والمائل والمشطوب، الرسائل النصية أو رسائل البطاقة
• النص المرتبط:
• الإشارة باستخدام@إلى مستخدم واحد أو جميع المستخدمين في "مساحة Chat".
• إضافة ميزات مضمّنة أو رموز مخصّصة في رسائل البطاقات فقط

تنسيق رسالة نصية

يتيح لك Chat إضافة التنسيق الأساسي إلى الرسالة النصية، بما في ذلك وغامق ومائل ومشطوب، باستخدام مجموعة فرعية صغيرة من بناء جملة Markdown. إِنْتَ تنسيق النص في الرسائل النصية بشكل مختلف عن تنسيق رسائل البطاقات لأن يتم تنسيق الرسائل بنفس البنية التي يستخدمها Chat التي يستخدمها المستخدمون. لتنسيق النص الذي يظهر في بطاقة، راجِع ما يلي: تنسيق رسالة البطاقة

لتنسيق الرسائل النصية، استخدِم البنية التالية:

التنسيق	الرمز	مثال على البنية	النص المعروض في Google Chat
غامق	*	*مرحبًا*	مرحبًا
مائل	_ (شرطة سفلية)	_hello_	مرحبًا
نص مشطوب	~	~مرحبًا~	مرحبًا
Monospace	` (علامة اقتباس للخلف)	"مرحبًا"	hello
مربّع أحادي المسافة	` ` ` (ثلاث علامتَي اقتباس)	``` Hello World ```	Hello World
قائمة نقطية	* أو - (واصلة) متبوعة بمسافة	* هذا هو العنصر الأول في القائمة * هذا هو العنصر الثاني في القائمة	هذا هو العنصر الأول في القائمة هذا هو العنصر الثاني في القائمة

على سبيل المثال، يمكنك استخدام تنسيق JSON التالي:

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

تعرض هذه الرسالة النصية المنسَّقة ما يلي في Chat. مساحة:

عرض تنسيق النص المُرسل في رسالة

عندما يرسل مستخدم رسالة، يظهر نص الرسالة العادي في الحقل "text". بعض التنسيقات التي يتم تطبيقها على الرسالة النصية باستخدام Markdown موجودة في الحقل text. يتوفّر تنسيق إضافي في العنصر حقل formattedText للمخرجات فقط، بما في ذلك ما يلي:

• بناء جملة Markdown إضافية للنص
• إشارات المستخدمين
• الارتباطات التشعبية المخصصة
• رموز الإيموجي المخصّصة

على سبيل المثال، يمكنك الاطّلاع على النص التالي الذي أرسله المستخدم:

إذا تم تنسيق الرسالة باستخدام القائمة تنسيق في واجهة مستخدم Chat، يحتوي الحقل 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>	Example website

يعتبر الممر ونص الرابط اختياريًا، بحيث لا يمكن لـ <https://www.example.com/> https://www.example.com/ مكافئة.

الإشارة إلى المستخدمين في رسالة نصية

بإمكان تطبيقات Chat إرسال رسائل نصية الإشارة باستخدام @إلى مستخدم واحد أو جميع المستخدمين في "مساحة Chat". لا يمكن لتطبيقات Chat الإشارة إلى مستخدمين في المساحة التي تكون في وضع الاستيراد أو أي مستخدمين لم ينضموا إلى المساحة.

الإشارة إلى مستخدمين محدّدين باستخدام @

للإشارة باستخدام @إلى مستخدم محدّد، أضِف <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" في Google Chat مورد User، مثل 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. تنسيق النص في رسائل البطاقة يختلف عن تنسيقه في الرسائل النصية الرسائل لأن الرسائل النصية يتم تنسيقها بنفس البنية التي يستخدمه مستخدمو المحادثة. لتنسيق النص الذي يظهر في رسالة نصية، الرؤية تنسيق رسالة نصية:

---

يمكنك استخدام "أداة إنشاء البطاقات" لتصميم رسائل بطاقات 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>."	هذا الخط الأحمر.
Hyperlink	"This is a <a href=\"https://www.google.com\">hyperlink</a>."	هذا رابط تشعّبي.
الوقت	"This is a time format: <time>2023-02-16 15:00</time>."	هذا تنسيق الوقت بالتنسيق: 2023-02-16 15:00.
سطر جديد	"This is the first line. <br> This is a new line. بوصة	هذا هو السطر الأول. هذا سطر جديد.

إضافة رمز مدمج إلى بطاقة

تشير رسالة الأشكال البيانية DecoratedText أو ButtonList تطبيقات مصغّرة تتيح العنصر icon استخدامه لتحديد أحد الرموز المضمنة المتاحة في Chat.

يعرض الجدول التالي الرموز المضمّنة المتاحة لرسائل البطاقات:

flight	طائرة	bookmark	الإشارة المرجعية
directions_bus	حافلة	directions_car	سيارة
schedule	الساعة	confirmation_number	CONFIRMATION_NUMBER_ICON
subject	الوصف	attach_money	دولار
mail	البريد الإلكتروني	event_seat	EVENT_SEAT
flight_land	FLIGHT_ARRIVAL	flight_takeoff	FLIGHT_DEPARTURE
hotel	الفندق	grade	HOTEL_ROOM_TYPE
insert_invitation	INVITE	location_on	MAP_PIN
card_membership	العضوية	people	MULTIPLE_PEOPLE
person	الشخص	local_phone	الهاتف
restaurant	RESTAURANT_ICON	shopping_cart	SHOPPING_CART
grade	النجمة	store	المتجر
local_play	التذكرة	train	القطار
videocam	VIDEO_CAMERA	play_circle_filled	VIDEO_PLAY

تشير رسالة الأشكال البيانية فيما يلي مثال على بطاقة بها رمز بريد إلكتروني:

إضافة رمز Google Material Design إلى بطاقة

تشير رسالة الأشكال البيانية DecoratedText أو ButtonList التطبيقات المصغّرة التي تتيح لك استخدام رموز Material من Google كي تتمكّن من الاختيار من بين أكثر من 2,500 خيار للرموز وتخصيص وسُمك وتعبئة ودرجة الأيقونات.

في ما يلي مثال على بطاقة تحمل رمز Google Material:

إضافة رمز مخصّص إلى بطاقة

تشير رسالة الأشكال البيانية DecoratedText أو ButtonList تتيح لك التطبيقات المصغّرة استخدام الرموز المدمَجة أو تحديد رموزك المخصّصة. إلى أضف رمزًا مخصصًا إلى بطاقة، وضمِّن الحقل iconUrl وحدد عنوان URL المقابل.

إليك مثال على رمز مخصّص: