نظرة عامة على رسائل Google Chat

توضّح هذه الصفحة أوجه الاختلاف بين الرسائل النصية ورسائل البطاقات.

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

بنية الرسالة النصية

في Google Chat API، يتم تمثيل الرسائل كعناصر JSON. داخل الرسالة، يتم تمثيل رسالة نصية على أنها text .

في ما يلي مثال، ينشئ تطبيق Chat رسالة نصية في مساحة بالنسبة إلى فريق من مطوري البرامج قريبًا من تجميد الرموز:

{
  "text": "Attention <users/all>: Code freeze starts at `11:59 am` Pacific Standard Time! If you need a little more time, type `/moreTime` and I'll push the code freeze back one hour."
}

يعرض ملف JSON الرسالة التالية:

مثال على رسالة نصية في Google Chat تعلن عن تجميد الرموز

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

في Google Chat API، يتم تمثيل الرسائل كعناصر JSON. ضمن رسالة، يتم تمثيل البطاقة على هيئة صفيف cardsV2 وتتألف من ما يلي:

  • عنصر واحد أو أكثر CardWithId
  • cardId، تُستخدَم لتحديد البطاقة وتحديد نطاقها ضمن رسالة معيّنة. (يمكن أن يكون للبطاقات في رسائل مختلفة رقم التعريف نفسه).

  • عنصر card الذي يتألف مما يلي:

    • كائن header تحدد أشياء مثل العنوان والعنوان الفرعي والصورة بنمط الأفاتار.
    • واحد أو أكثر عنصرَين (section) أن يحتوي كل منها على أداة واحدة على الأقل
    • عنصر واحد أو أكثر widget كل تطبيق مصغّر هو كائن مركب يمكنه أن يمثل النصوص والصور والأزرار وأنواع الكائنات الأخرى.

على سبيل المثال، تحتوي رسالة البطاقة التالية على العناصر header و section و widget:

تطبيق في Chat يُجري استطلاعًا في Chat مسافة باستخدام بطاقة رسالة

يمثّل الرمز التالي تنسيق JSON لرسالة البطاقة:

JSON

{
  "cardsV2": [
    {
      "cardId": "unique-card-id",
      "card": {
        "header": {
          "title": "Sasha",
          "subtitle": "Software Engineer",
          "imageUrl": "https://developers.google.com/chat/images/quickstart-app-avatar.png",
          "imageType": "CIRCLE",
          "imageAltText": "Avatar for Sasha"
        },
        "sections": [
          {
            "header": "Contact Info",
            "collapsible": true,
            "uncollapsibleWidgetsCount": 1,
            "widgets": [
              {
                "decoratedText": {
                  "startIcon": {
                    "knownIcon": "EMAIL"
                  },
                  "text": "sasha@example.com"
                }
              },
              {
                "decoratedText": {
                  "startIcon": {
                    "knownIcon": "PERSON"
                  },
                  "text": "<font color=\"#80e27e\">Online</font>"
                }
              },
              {
                "decoratedText": {
                  "startIcon": {
                    "knownIcon": "PHONE"
                  },
                  "text": "+1 (555) 555-1234"
                }
              },
              {
                "buttonList": {
                  "buttons": [
                    {
                      "text": "Share",
                      "onClick": {
                        "openLink": {
                          "url": "https://example.com/share"
                        }
                      }
                    },
                    {
                      "text": "Edit",
                      "onClick": {
                        "action": {
                          "function": "goToView",
                          "parameters": [
                            {
                              "key": "viewType",
                              "value": "EDIT"
                            }
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  ]
}

استخدِم "أداة إنشاء البطاقات" لتصميم ومعاينة الرسائل وواجهات المستخدم لتطبيقات Chat:

افتح "أداة إنشاء البطاقات".