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

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

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

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

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

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

* هذا هو أول عنصر في القائمة.

* هذا هو العنصر الثاني في القائمة.
  • هذا هو أول عنصر في القائمة
  • هذا هو العنصر الثاني في القائمة

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

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

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

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

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

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

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

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

رسالة مُستلمة في Chat تشتمل على الكلمة

إذا تم تنسيق الرسالة باستخدام القائمة التنسيق في واجهة مستخدم 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 المحدّد.

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

مثال على البنية النص المعروض في 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. لتنسيق النص الذي يظهر في رسالة نصية، راجع تنسيق رسالة نصية.

يمكنك استخدام "أداة إنشاء البطاقات" لتصميم رسائل بطاقة JSON ومعاينتها لتطبيقات 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
ميزة STAR المتجر
تذكرة TRAIN
VIDEO_CAMERA VIDEO_PLAY

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

إضافة رمز Google Material Design إلى بطاقة

تتيح لك تطبيقات DecoratedText وButtonList استخدام رموز Google Material بحيث يمكنك الاختيار من بين أكثر من 2500 خيار للرموز وتخصيص وزن الرموز وتعبئتها ودرجتها.

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

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

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

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