Google Chat メッセージの概要

このページでは、テキスト メッセージとカード メッセージの違いについて説明します。

Chat アプリからテキスト メッセージを送信して基本情報を伝える際に、 メッセージは、Google Chat のユーザーが入力するようにインラインで表示され、 ブロックすることもできます。テキスト以外の内容のメッセージを作成したり、 Chat アプリはユーザーが操作できるメッセージのほか、 カード。 Chat アプリでは、カード付きのテキスト メッセージを追加することもできます。宛先 フォームの記入 Chat アプリでは、新しいウィンドウで開くカードを作成できます。 ダイアログ。

テキスト メッセージの構造

Google Chat API では、メッセージは JSON オブジェクトとして表されます。メールでは テキスト メッセージはテキスト メッセージが text 渡されます。

実際に Chat アプリがスペース内でテキスト メッセージを作成して コードフリーズが迫っているという SW 開発者チームにとってのメリットです

{
  "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 次の要素で構成されます。

  • 1 つ以上 CardWithId オブジェクト。
  • cardId。カードの識別に使用され、特定のメッセージの範囲になります。 （異なるメッセージのカードに同じ ID を設定することもできます）。

  • card オブジェクト。次の要素で構成されます。

    • header オブジェクト は、タイトル、サブタイトル、アバター形式の画像などを指定します。
    • 1 つ以上 section オブジェクト それぞれに 1 つ以上のウィジェットが 含まれています
    • 1 つ以上 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": "[email protected]"
                }
              },
              {
                "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 用アプリ用の JSON カード メッセージを設計し、プレビューします。

カードビルダーを開く