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

אתם יכולים להשתמש בכלי ליצירת כרטיסים כדי לעצב הודעות של כרטיסי JSON ולהציג אותן בתצוגה מקדימה בשביל אפליקציות ל-Chat:

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