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

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

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

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

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

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

على سبيل المثال، يمكنك استخدام تنسيق 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 المحدّد.

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

يُعتبر الممر ونص الرابط اختياريًا، لذا يكون <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. يتم تنسيق النص بشكل مختلف في رسائل البطاقات عن رسائل الرسائل النصية لأنّ رسائل الرسائل النصية يتم تنسيقها باستخدام البنية نفسها التي يستخدمها مستخدمو Chat.

استخدِم "أداة إنشاء البطاقات" لتصميم رسائل وواجهات مستخدم لتطبيقات Chat ومعاينتها:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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