نظرة عامة على رسائل 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"
                            }
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  ]
}

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

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