סקירה כללית על הודעות ב-Google Chat

בדף הזה מוסבר מה ההבדל בין הודעות טקסט להודעות בכרטיס.

כשאפליקציות Chat שולחות הודעות טקסט כדי להעביר מידע בסיסי, ההודעות מופיעות בשרשורים, בדיוק כמו שאנשים כותבים הודעות ב-Google 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 ולראות תצוגה מקדימה שלהן:

פתיחת הכלי ליצירת כרטיסים