يتيح لك Google Chat إضافة تنسيق إلى الرسائل، ويشمل ذلك ما يلي:
- تنسيق النص الأساسي، مثل الخط الغامق والمائل والمشطوب في الرسائل النصية ورسائل البطاقات
- النص المرتبط.
- أشِر إلى مستخدم واحد أو جميعهم في مساحة Chat.
- أضِف رموزًا مدمجة ومخصَّصة في رسائل البطاقات فقط.
تنسيق رسالة نصية
يتيح لك Google Chat إضافة تنسيق أساسي إلى رسالة نصية، بما في ذلك الخط الغامق والمائل والمخطَّط، باستخدام مجموعة فرعية صغيرة من بنية Markdown. يمكنك تنسيق النص في الرسائل النصية بشكل مختلف عن رسائل البطاقات لأنّ الرسائل النصية يتم تنسيقها بالبنية نفسها التي يستخدمها مستخدمو Chat. لتنسيق النص الذي يظهر في بطاقة، يُرجى الاطّلاع على تنسيق رسالة بطاقة.
لتنسيق الرسائل النصية، استخدِم البنية التالية:
التنسيق | الرمز | مثال على البنية | النص المعروض في Google Chat |
---|---|---|---|
غامق | * | *مرحبًا* | مرحبًا |
مائل | _ (شرطة سفلية) | _مرحبًا_ | مرحبًا |
مشطوب | ~ | ~مرحبًا~ | |
Monospace | ` (علامة اقتباس خلفية) | "مرحبًا" | hello |
قطعة أحادية المسافة | ` ` `` (ثلاث علامتَي اقتباس مع خلفية) | ``` مرحبًا العالم ``` |
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 ChatUser
، مثل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 المقابل للرمز.
في ما يلي مثال على رمز مخصّص: