تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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

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

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

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

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

بالنسبة إلى الرسائل المُرسَلة أو التي تم استردادها باستخدام Chat API، يمكنك استخدام بنية Markdown العادية (MARKUP_SYNTAX_MARKDOWN) أو بنية ترميز Chat (MARKUP_SYNTAX_CHAT). يمكنك ضبط بنية الترميز التلقائية على مستوى التطبيق في وحدة تحكّم Google Cloud (يُرجى الاطّلاع على ضبط Google Chat API):

Markdown: صيغة Markdown العادية (MARKUP_SYNTAX_MARKDOWN)، استنادًا إلى مواصفات CommonMark مع إضافات أخرى تستخدم تطبيقات Chat التي تم إنشاؤها حديثًا تنسيق Markdown تلقائيًا.
Chat: صيغة ترميز Chat (MARKUP_SYNTAX_CHAT). تستخدم تطبيقات Chat الحالية Chat تلقائيًا للحفاظ على التوافق مع الأنظمة القديمة.

يمكنك أيضًا تحديد markup_syntax في طلبات بيانات من واجهة برمجة التطبيقات الفردية في Chat لتجاوز الإعداد التلقائي على مستوى التطبيق. عندما لا يتم تحديد markup_syntax في طلب بيانات من واجهة برمجة التطبيقات، يتم ضبط الترميز استنادًا إلى كيفية طلب Chat API:

تطبيقات Chat التي تم ضبطها: تستخدم بنية الترميز المحفوظة في صفحة إعدادات Chat API.
مشاريع على السحابة الإلكترونية غير المضبوطة (بدون ضبط): إذا كان مشروع على السحابة الإلكترونية يرسل طلبات إلى Chat API بدون حفظ إعدادات تطبيق Chat، يتم ضبط الطلبات تلقائيًا على MARKUP_SYNTAX_MARKDOWN.
الويب هوك الواردة: يتم ضبطها تلقائيًا على MARKUP_SYNTAX_CHAT. يُرجى الاطّلاع على إرسال الرسائل باستخدام الويب هوك الواردة.

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

التنسيق	MARKUP_SYNTAX_CHAT	MARKUP_SYNTAX_MARKDOWN	مثال على البنية	النص المعروض في Google Chat
غامق	`*`	`**`	`hello` أو: `hello`	مرحبًا
مائل	‫`_` (شَرطة سفلية)	`*`	`_hello_` أو: `hello`	مرحبًا
نص مشطوب	`~`	`~~`	`~hello~` أو: `~~hello~~`	~~مرحبًا~~
أحادي المسافة	` (علامة اقتباس خلفية)	` (علامة اقتباس خلفية)	"مرحبًا"	`hello`
مربّع أحادي المسافة	` ` ` (ثلاث علامات اقتباس مائلة)	` ` ` (ثلاث علامات اقتباس مائلة)	مرحبًا بالجميع ```	`Hello World`
قائمة نقطية	* أو - (واصلة) متبوعة بمسافة	* أو - (واصلة) متبوعة بمسافة	* هذا هو العنصر الأول في القائمة. * هذا هو العنصر الثاني في القائمة.	هذا هو العنصر الأول في القائمة. هذا هو العنصر الثاني في القائمة.
قائمة متداخلة	‫* أو - (واصلة) متبوعة بمسافة، ومسبوقة بأربع مسافات لكل مستوى متداخل	‫* أو - (واصلة) متبوعة بمسافة، ومسبوقة بأربع مسافات لكل مستوى متداخل	‫* هذا هو العنصر الذي يتضمّن عمقًا متداخلاً واحدًا في القائمة. * This is the item with nested depth two in the list. * This is the item with nested depth three in the list.	هذا هو العنصر الذي يحتوي على عمق متداخل واحد في القائمة. هذا هو العنصر ذو العمق المتداخل اثنين في القائمة. هذا هو العنصر ذو العمق المتداخل ثلاثة في القائمة.
قائمة مرقّمة	غير متاح	1. (رقم متبوع بنقطة ومسافة)	1. هذا هو العنصر الأول في القائمة. 2. هذا هو العنصر الثاني في القائمة.	هذا هو العنصر الأول في القائمة. هذا هو العنصر الثاني في القائمة.
حظر الاقتباس	> (علامة أكبر من)	> (علامة أكبر من)	>مرحبًا	مرحبًا
Hyperlink	`<hyperlink\|display text>`	`[display text](hyperlink)`	`<https://example.com\|Example website>` أو: `[Example website](https://example.com)`	مثال على موقع إلكتروني لمزيد من المعلومات حول إنشاء الروابط التشعبية، يُرجى الاطّلاع على تنسيق الروابط.
الإشارة إلى مستخدم	`<users/{user}>` حيث يمثّل `{user}` رقم تعريف المستخدم.	`<chat-user data-user="users/{user}">` أو: `<chat-user data-email="{email}">`	`<users/123456789012345678901>` أو `<users/all>` أو: `<chat-user data-user="users/123456789012345678901">`، ‫`<chat-user data-user="users/all">` أو `<chat-user data-email="email@example.com">`	@Mahan S لمزيد من المعلومات حول الإشارة إلى المستخدمين، يُرجى الاطّلاع على الإشارة إلى المستخدمين في رسالة نصية.
Custom Emoji	`<customEmojis/{uid}>` أو: `<customEmojis/:{name}:>`	`<chat-emoji data-custom-emoji="customEmojis/{uid}">` أو: `<chat-emoji data-emoji-name=":{name}:">`	`<customEmojis/abc-123-def>` أو: `<customEmojis/:smiley-cat:>` أو: `<chat-emoji data-custom-emoji="customEmojis/abc-123-def">` أو: `<chat-emoji data-emoji-name=":smiley-cat:">`	🐱 (إيموجي مخصّص لوجه قطة مبتسم)
معلومات الكتاب	غير متاح	‫`<chat-citation data-id="{id}">{text}</chat-citation>` حيث `{id}` هو معرّف الاقتباس المحدّد في الرسالة `elements`.	`<chat-citation data-id="cite_1">cited text</chat-citation>`	النص المقتبس لمزيد من المعلومات عن الاقتباسات، يُرجى الاطّلاع على المقالة إضافة اقتباسات إلى رسالة نصية.

على سبيل المثال، إليك ملف 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 المحدّد.

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

بالنسبة إلى رسائل واجهة برمجة التطبيقات التي تم ضبطها باستخدام Markdown، استخدِم البنية العادية لروابط Markdown:

مثال على البنية النص المعروض في Google Chat

[Example website](https://example.com)
Example website
بالنسبة إلى الرسائل النصية العادية، استخدِم البنية العمودية:

مثال على البنية النص المعروض في Google Chat

<https://example.com|Example website>
Example website

يُعدّ الرمز العمودي ونص الرابط اختياريَين، لذا فإنّ <https://example.com> وhttps://example.com متكافئان.

مثال على البنية	النص المعروض في Google Chat
`[Example website](https://example.com)`	Example website

مثال على البنية	النص المعروض في Google Chat
`<https://example.com\|Example website>`	Example website

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

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

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

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

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

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

إذا كان تطبيقك يرسل رسائل باستخدام بنية Markdown، يمكنك تحديد رموز إيموجي مخصّصة بتنسيق علامة HTML باستخدام معرّف الإيموجي المخصّص:

{
  "text": "Hello <chat-emoji data-custom-emoji=\"customEmojis/CUSTOM_EMOJI_ID\">."
}

أو يمكنك تحديد اسم الإيموجي المخصّص:

{
  "text": "Hello <chat-emoji data-emoji-name=\"CUSTOM_EMOJI_NAME\">."
}

لاستخدام هذه النماذج، استبدِل CUSTOM_EMOJI_ID بمعرّف الإيموجي المخصّص، وCUSTOM_EMOJI_NAME باسم الرمز المختصر للإيموجي المخصّص.

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

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

لا تتيح الرسائل الصامتة الإشارة إلى المستخدمين. يؤدي تضمين إشارة في رسالة صامتة إلى ظهور خطأ.

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

للإشارة إلى مستخدم معيّن، أضِف <users/{user}> إلى الرسالة النصية حيث {user} هو معرّف المستخدم. على سبيل المثال، لنفترض أنّ الرسالة النصية التالية تتضمّن 123456789012345678901 الذي يمثّل رقم تعريف المستخدم "ماهر":

{
    "text": "A customer has reported an issue. Assigning ticket #942 to <users/123456789012345678901>."
}

إذا كان تطبيقك يرسل رسائل باستخدام بنية Markdown، استخدِم تنسيق علامة HTML chat-user لتحديد رقم تعريف المستخدم:

{
  "text": "Assigning ticket #942 to <chat-user data-user=\"users/123456789012345678901\">."
}

أو حدِّد حسب البريد الإلكتروني:

{
  "text": "Assigning ticket #942 to <chat-user data-email=\"mahan@example.com\">."
}

تظهر الرسالة النصية على النحو التالي:

يشير تطبيق 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!"
}

إذا كان تطبيقك يرسل رسائل باستخدام بنية Markdown، حدِّد الإشارة باستخدام تنسيق علامة HTML chat-user:

{
  "text": "Important message for <chat-user data-user=\"users/all\">: Code freeze starts at midnight tonight!"
}

إضافة معلومات المقالة إلى رسالة نصية

يمكن أن تتضمّن تطبيقات Chat اقتباسات في الرسائل النصية لتوفير معلومات مفصّلة عن المصدر للمستخدمين. يمكنك تقديم المصادر بطريقتَين:

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

لا تتوفّر الاقتباسات إلا عندما يتم ضبط السمة markupSyntax للرسالة على MARKUP_SYNTAX_MARKDOWN. لا تتوفّر هذه الميزة إلا من خلال إنشاء الرسائل غير المتزامنة باستخدام Chat API.

لإضافة اقتباسات مضمّنة إلى رسالة:

قدِّم المصادر في قائمة citations للرسالة elements، مع تخصيص id فريد لكل عنصر Citation.
في نص الرسالة، يمكنك تضمين النص الذي تريد اقتباسه باستخدام تنسيق علامة HTML‏ chat-citation: <chat-citation data-id="{id}">{text}</chat-citation>. تأكَّد من أنّ السمة {id} تتطابق مع المعرّف الذي حدّدته في السمة elements. ويتم تجاهل الاقتباسات التي لا تتضمّن مرجعًا (تلك التي لا تحتوي على علامة مطابقة).

{
  "text": "This is a <chat-citation data-id=\"cite_1\">cited</chat-citation> text.",
  "markupSyntax": "MARKUP_SYNTAX_MARKDOWN",
  "elements": {
    "citations": [
      {
        "id": "cite_1",
        "citedSources": [
          {
            "title": "Example Source",
            "uri": "https://example.com"
          }
        ]
      }
    ]
  }
}

لإضافة مصادر التذييل إلى رسالة، قدِّم المصادر في قائمة citedSources للرسالة elements. تظهر أي مصادر يتم تقديمها هنا تلقائيًا أسفل الرسالة كروابط تذييل، ولا تتطلّب أي علامات مضمّنة في نص الرسالة.

{
  "text": "This is a message with a footer source.",
  "markupSyntax": "MARKUP_SYNTAX_MARKDOWN",
  "elements": {
    "citedSources": [
      {
        "title": "Example Source",
        "uri": "https://example.com"
      }
    ]
  }
}

تنسيق النص الذي يظهر في البطاقات

داخل البطاقات، تتيح معظم الحقول النصية تنسيق النص الأساسي باستخدام مجموعة فرعية صغيرة من علامات HTML. يختلف تنسيق النص في رسائل البطاقات عن تنسيق النص في الرسائل النصية لأنّ الرسائل النصية يتم تنسيقها باستخدام البنية نفسها التي يستخدمها مستخدمو Chat.

استخدِم "أداة إنشاء البطاقات" لتصميم ومعاينة واجهات المستخدم والرسائل لتطبيقات 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>."`	هذا هو تنسيق الوقت: ‎2023-02-16 15:00.
سطر جديد	`"This is the first line. <br> This is a new line.`"	هذا هو السطر الأول. هذا سطر جديد.

لتحديد القوائم ومجموعات الرموز، استخدِم العلامات التالية:

التنسيق	مثال	النتيجة المعروضة
سطر جديد	`"Line 1<br>Line 2"`	السطر 1 السطر 2
أحادي المسافة	`"This is an <code>inline code</code>."`	هذا `inline code`.
مربّع أحادي المسافة	`"<pre><code>This a code block.</code></pre>"`	`This is a code block.`
قائمة نقطية	`"<ul><li>List item 1</li><li>List item 2</li></ul>"`	List item 1 List item 2
قائمة مع ترتيب	`"<ol><li>List item 1</li><li>List item 2</li></ol>"`	List item 1 List item 2

Markdown

عند تفعيل بنية Markdown، يمكنك استخدام البنية التالية:

التنسيق	مثال	النتيجة المعروضة
غامق	مرحبًا أو __مرحبًا__	مرحبًا
مائل	مرحبًا أو _مرحبًا_	مرحبًا
نص مشطوب	~مرحبًا~	~~مرحبًا~~
أحادي المسافة	"مرحبًا"	`hello`
مربّع أحادي المسافة	مرحبًا بالجميع ```	`Hello World`
قائمة نقطية	- هذا هو العنصر الأول في القائمة - هذا هو العنصر الثاني في القائمة	هذا هو العنصر الأول في القائمة هذا هو العنصر الثاني في القائمة
قائمة نقطية	* هذا هو العنصر الأول في القائمة * هذا هو العنصر الثاني في القائمة	هذا هو العنصر الأول في القائمة هذا هو العنصر الثاني في القائمة
قائمة مع ترتيب	1. هذا هو العنصر الأول في القائمة 2. هذا هو العنصر الثاني في القائمة	هذا هو العنصر الأول في القائمة هذا هو العنصر الثاني في القائمة
Hyperlink	[مثال على موقع إلكتروني](https://example.com)	مثال على موقع إلكتروني

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

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

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

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

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

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

	AIRPLANE		BOOKMARK
	BUS		CAR
	CLOCK		CONFIRMATION_NUMBER_ICON
	الوصف		DOLLAR
	EMAIL		EVENT_SEAT
	FLIGHT_ARRIVAL		FLIGHT_DEPARTURE
	HOTEL		HOTEL_ROOM_TYPE
	INVITE		MAP_PIN
	العضوية		MULTIPLE_PEOPLE
	PERSON		PHONE
	RESTAURANT_ICON		SHOPPING_CART
	STAR		المتجر
	TICKET		TRAIN
	VIDEO_CAMERA		VIDEO_PLAY

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

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

يمكنك استخدام رموز متوافقة مع إرشادات التصميم المتعدّد الأبعاد من Google للاختيار من بين أكثر من 2,500 رمز وتخصيص سمك الرموز وتعبئتها ودرجتها.

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

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

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

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