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

يتيح لك Google Chat إضافة تنسيق إلى الرسائل، ويشمل ذلك ما يلي:

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

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

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

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

على سبيل المثال، ضع في الاعتبار تنسيق JSON التالي:

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

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

يرسل تطبيق Cymbal Pizza رسالة نصية تفيد بأن التوصيل قد وصل.

عرض تنسيق النص الذي تم إرساله في رسالة

عندما يرسل مستخدم رسالة، يكون نص الرسالة العادية في الحقل text. توجد بعض التنسيقات التي يتم تطبيقها على الرسالة النصية باستخدام بنية Markdown في حقل text. ويتوفر التنسيق الإضافي في حقل formattedText للمخرجات فقط، بما في ذلك ما يلي:

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

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

رسالة تم تلقّيها في محادثة تتضمّن الكلمة

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

رسالة بالكلمة

يتم تلقي الرسالة بالتنسيق التالي:

    {
      "text": "Be there at noon!",
      "formattedText": "Be <http://example.com|there> at *noon*",
    }

في حال تضمين عنوان 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 معرّف المستخدم Mahan S.:

{
    "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 لتحديد رقم تعريف المستخدم.

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

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

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

تنسيق رسالة البطاقة

داخل البطاقات، تدعم معظم الحقول النصية تنسيق النص الأساسي باستخدام مجموعة فرعية صغيرة من علامات HTML. يمكنك تنسيق النص في رسائل البطاقات بشكل مختلف عن الرسائل النصية، لأنه يتم تنسيق الرسائل النصية بالبنية نفسها التي يستخدمها مستخدمو 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>." هذا هو الخط الأحمر.
رابط تشعّبي "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 مع العنصر icon المستخدَم لتحديد أحد الرموز المضمّنة المتوفّرة في Chat.

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

طائرة BOOKMARK
BUS السيارة
الساعة CONFIRMATION_NUMBER_ICON
الوصف الدولار
البريد الإلكتروني EVENT_SEAT
FLIGHT_ARRIVAL FLIGHT_DEPARTURE
الفندق HOTEL_ROOM_TYPE
دعوة MAP_PIN
الاشتراك MULTIPLE_PEOPLE
الشخص الهاتف
RESTAURANT_ICON SHOPPING_CART
النجمة المتجر
التذكرة TRAIN
VIDEO_CAMERA VIDEO_PLAY

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

إضافة رمز مخصّص إلى بطاقة

تتيح لك الأداتان DecoratedText وButtonList استخدام الرموز المضمّنة أو تحديد رموزك المخصّصة. لتحديد رمز مخصّص، استخدِم العنصر iconUrl كما هو موضّح في المثال التالي: