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

توضّح هذه الصفحة كيفية تنسيق تطبيقات Google Chat للنص لإرسال رسائل تحتوي على أيّ مما يلي:

  • نصّ غني يحتوي على روابط تشعبية أو إشارات إلى مستخدم واحد أو جميع المستخدمين في مساحة Chat
  • النص الذي يظهر في واجهة البطاقة، بما في ذلك نص الفقرة أو نص واجهة المستخدم الذي يظهر بجانب رمز، مثل زر

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

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

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

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

* هذا هو العنصر الأول في القائمة.

* هذا هو العنصر الثاني في القائمة.
  • هذا هو العنصر الأول في القائمة.
  • هذا هو العنصر الثاني في القائمة.

على سبيل المثال، إليك ملف JSON التالي:

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

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

يرسل تطبيق Cymbal Pizza رسالة نصية لإعلام العميل بوصول الطلب.

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

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

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

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

تم تلقّي رسالة في Chat تتضمّن الكلمة

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

إنّ رمز الربط ونص الرابط اختياريان، لذا يكون <https://www.example.com/> و https://www.example.com/ متكافئَين.

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

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

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

للإشارة إلى مستخدم معيّن، أضِف <users/{user}> إلى الرسالة النصية حيث {user} هو معرّف المستخدم. على سبيل المثال، راجِع الرسالة النصية التالية التي يمثّل فيها 123456789012345678901 رقم تعريف المستخدم "محسن سمير":

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

تظهر الرسالة النصية على النحو التالي:

يشير تطبيق Chat إلى مستخدم في رسالة نصية.

يمكنك تحديد قيمة 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 method لتحديد رقم تعريف المستخدم.

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

لإنشاء رسالة نصية تشير إلى الجميع في مساحة باستخدام @، استبدِل {user} بـ all. يشير مثال JSON التالي إلى جميع المستخدمين في رسالة:

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

تنسيق النص الذي يظهر في البطاقات

داخل البطاقات، تتيح معظم الحقول النصية تنسيق النصوص الأساسية باستخدام مجموعة صغيرة من علامات HTML. يتم تنسيق النص بشكل مختلف في رسائل البطاقات عن رسائل النص لأنّ رسائل النص يتم تنسيقها باستخدام البنية نفسها التي يستخدمها مستخدمو Chat.

استخدِم "أداة إنشاء البطاقات" لتصميم واجهتَي المستخدم والرسائل ومعاينتهما في تطبيقات 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>." هذا تنسيق وقت: .
سطر جديد "This is the first line. <br> This is a new line." هذا هو السطر الأول.
هذا سطر جديد.

إضافة رموز إلى النص

لعرض الرموز بجانب النص في البطاقة، يمكنك استخدام التطبيقات المصغّرة DecoratedText و ButtonList.

توضّح الأقسام التالية كيفية استخدام الرموز المضمّنة أو رموز Google Material أو الرموز المخصّصة في النصوص أو الأزرار المزخرفة.

استخدام الرموز من Chat

لاستخدام رموز مضمّنة متوفّرة في Chat، حدِّد أحد الخيارَين التاليَين:

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

AIRPLANE وضع إشارة
BUS CAR
الساعة CONFIRMATION_NUMBER_ICON
الوصف DOLLAR
البريد الإلكتروني EVENT_SEAT
FLIGHT_ARRIVAL FLIGHT_DEPARTURE
فندق HOTEL_ROOM_TYPE
INVITE MAP_PIN
الاشتراك MULTIPLE_PEOPLE
شخص PHONE
RESTAURANT_ICON SHOPPING_CART
STAR المتجر
TICKET TRAIN
VIDEO_CAMERA VIDEO_PLAY

في ما يلي مثال على بطاقة تتضمّن رمز بريد إلكتروني:

استخدام رموز Google Material

يمكنك استخدام رموز Google Material للاختيار من بين أكثر من 2500 خيار رمز وتخصيص الوزن والتعبئة والدرجة للرموز.

في ما يلي مثال على بطاقة تتضمّن رمزًا من واجهة مستخدم Google Material:

استخدام رموز مخصّصة

لإضافة رمز مخصّص، أدرِج الحقل iconUrl وحدِّد عنوان URL المرتبط بالرمز.

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