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

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

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

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

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

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

على سبيل المثال، إليك عنصر JSON التالي:

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

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

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

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

استخدام رموز إيموجي مخصّصة في رسالة نصية

يمكن لتطبيقات المحادثة إرسال رسائل نصية تتضمّن رموز إيموجي مخصّصة لتخصيص الرسائل. لا تتوفّر رموز الإيموجي المخصّصة إلا لمؤسسات Google Workspace، ويجب أن يفعّلها المشرف للمؤسسة. لمزيد من المعلومات، يُرجى الاطّلاع على المقالتَين التعرّف على الرموز التعبيرية المخصصة في Google Chat وإدارة أذونات رموز الإيموجي المخصّصة.

لإنشاء رسائل باستخدام رموز إيموجي مخصّصة، يجب أن يستخدم تطبيقك مصادقة المستخدم. لا تتوافق الرموز التعبيرية المخصّصة مع الرسائل التي يتم إنشاؤها كخطاف ويب أو الرسائل التي يتم إنشاؤها باستخدام مصادقة التطبيق.

لإضافة إيموجي مخصّص إلى نص الرسالة، حدِّد name أو emoji_name لمورد customEmoji:

{
    "text": "Hello <customEmojis/CUSTOM_EMOJI_ID>."
}

لاستخدام هذا النموذج، استبدِل CUSTOM_EMOJI_ID بمعرّف الإيموجي المخصّص. يمكنك العثور على هذا المعرّف في حقل name أو emoji_name في المورد customEmoji.

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

يمكن لتطبيقات 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 الخاص بمورد User في Google Chat، مثل 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 ومعاينتها:

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

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

بالإضافة إلى ذلك، يمكن استخدام بنية Markdown والعلامات التالية:

This is a code block.

لتحديد بنية الجملة التي سيتم استخدامها عند تنسيق محتوى فقرة نصية، استخدِم الحقل بنية الجملة النصية.

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

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

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

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

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

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

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

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

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

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

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

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

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