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

توضّح هذه الصفحة كيف يمكن لتطبيقات 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:

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

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

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

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

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

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

لاستخدام الرموز المضمَّنة المتاحة في Chat، يُرجى اتّباع الخطوات التالية: حدد أيًا مما يلي:

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

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

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

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

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

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

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

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