يتيح لك Google Chat إضافة تنسيق إلى الرسائل، بما في ذلك ما يلي:
- يكون التنسيق الأساسي للنص، مثل الخط الغامق والمائل والمشطوب، الرسائل النصية أو رسائل البطاقة
- النص المرتبط:
- الإشارة باستخدام@إلى مستخدم واحد أو جميع المستخدمين في "مساحة Chat".
- إضافة ميزات مضمّنة أو رموز مخصّصة في رسائل البطاقات فقط
تنسيق رسالة نصية
يتيح لك Chat إضافة التنسيق الأساسي إلى الرسالة النصية، بما في ذلك وغامق ومائل ومشطوب، باستخدام مجموعة فرعية صغيرة من بناء جملة Markdown. إِنْتَ تنسيق النص في الرسائل النصية بشكل مختلف عن تنسيق رسائل البطاقات لأن يتم تنسيق الرسائل بنفس البنية التي يستخدمها Chat التي يستخدمها المستخدمون. لتنسيق النص الذي يظهر في بطاقة، راجِع ما يلي: تنسيق رسالة البطاقة
لتنسيق الرسائل النصية، استخدِم البنية التالية:
التنسيق | الرمز | مثال على البنية | النص المعروض في Google Chat |
---|---|---|---|
غامق | * | *مرحبًا* | مرحبًا |
مائل | _ (شرطة سفلية) | _hello_ | مرحبًا |
نص مشطوب | ~ | ~مرحبًا~ | |
Monospace | ` (علامة اقتباس للخلف) | "مرحبًا" | hello |
مربّع أحادي المسافة | ` ` ` (ثلاث علامتَي اقتباس) | ``` Hello World ``` |
Hello |
قائمة نقطية | * أو - (واصلة) متبوعة بمسافة | * هذا هو العنصر الأول في القائمة * هذا هو العنصر الثاني في القائمة |
|
على سبيل المثال، يمكنك استخدام تنسيق 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 المحدد.
لتوفير نص رابط بديل للرابط، استخدِم البنية التالية:
مثال على البنية | النص المعروض في 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>."
}
تظهر الرسالة النصية على النحو التالي:
يمكنك تحديد قيمة 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. تنسيق النص في رسائل البطاقة يختلف عن تنسيقه في الرسائل النصية الرسائل لأن الرسائل النصية يتم تنسيقها بنفس البنية التي يستخدمه مستخدمو المحادثة. لتنسيق النص الذي يظهر في رسالة نصية، الرؤية تنسيق رسالة نصية:
يمكنك استخدام "أداة إنشاء البطاقات" لتصميم رسائل بطاقات 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>." |
هذا الخط الأحمر. |
Hyperlink | "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.
يعرض الجدول التالي الرموز المضمّنة المتاحة لرسائل البطاقات:
طائرة | الإشارة المرجعية | ||
حافلة | سيارة | ||
الساعة | CONFIRMATION_NUMBER_ICON | ||
الوصف | دولار | ||
البريد الإلكتروني | EVENT_SEAT | ||
FLIGHT_ARRIVAL | FLIGHT_DEPARTURE | ||
الفندق | HOTEL_ROOM_TYPE | ||
INVITE | MAP_PIN | ||
العضوية | MULTIPLE_PEOPLE | ||
الشخص | الهاتف | ||
RESTAURANT_ICON | SHOPPING_CART | ||
النجمة | المتجر | ||
التذكرة | القطار | ||
VIDEO_CAMERA | VIDEO_PLAY |
تشير رسالة الأشكال البيانية فيما يلي مثال على بطاقة بها رمز بريد إلكتروني:
إضافة رمز Google Material Design إلى بطاقة
تشير رسالة الأشكال البيانية
DecoratedText
أو
ButtonList
التطبيقات المصغّرة التي تتيح لك استخدام رموز Material من Google
كي تتمكّن من الاختيار من بين أكثر من 2,500 خيار للرموز وتخصيص
وسُمك وتعبئة ودرجة الأيقونات.
في ما يلي مثال على بطاقة تحمل رمز Google Material:
إضافة رمز مخصّص إلى بطاقة
تشير رسالة الأشكال البيانية
DecoratedText
أو
ButtonList
تتيح لك التطبيقات المصغّرة استخدام الرموز المدمَجة أو تحديد رموزك المخصّصة. إلى
أضف رمزًا مخصصًا إلى بطاقة، وضمِّن الحقل iconUrl
وحدد
عنوان URL المقابل.
إليك مثال على رمز مخصّص: