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

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