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

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

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

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

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

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

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

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

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

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

عندما يُرسِل مستخدم رسالة، يكون نص الرسالة بتنسيق نص عادي في الحقل text. إنّ بعض التنسيقات التي يتم تطبيقها على الرسالة النصية باستخدام بنية Markdown تظهر في الحقل text. يتوفّر تنسيق إضافي في حقل output-only 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 المحدّد.

لتوفير نص رابط بديل للرابط، استخدم البنية التالية:

إنّ رمز الربط ونص الرابط اختياريان، لذا يكون <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>."
}

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

يمكنك تحديد قيمة 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 ومعاينتها:

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

تظهر العلامات المتوافقة والغرض منها في الجدول التالي:

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

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

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

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

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

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

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

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

يمكنك استخدام رموز Material من Google للاختيار من بين أكثر من 2,500 خيار للرموز وتخصيص وزن الرموز وملئها ودرجتها.

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

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

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

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