סקירה כללית על הודעות ב-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"
                            }
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  ]
}

עצב כרטיסים והצג תצוגה מקדימה שלהם באמצעות הכלי ליצירת כרטיסים.

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