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

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

عندما ترسل تطبيقات Chat رسائل نصية لإرسال معلومات أساسية، تظهر الرسائل مضمّنة، تمامًا مثل الطريقة التي يكتب بها المستخدمون في Google 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:

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