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


يمكنك تصميم البطاقات ومعاينتها باستخدام أداة إنشاء البطاقات.

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