このページでは、テキスト メッセージとカード メッセージの違いについて説明します。
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 API では、メッセージは JSON オブジェクトとして表されます。メール内
カードは
cardsV2
次の要素で構成されます。
- 1 つ以上
CardWithId
オブジェクト。 cardId
。カードの識別に使用され、特定のメッセージの範囲になります。 (異なるメッセージのカードに同じ ID を設定することもできます)。card
オブジェクト。次の要素で構成されます。header
オブジェクト は、タイトル、サブタイトル、アバター形式の画像などを指定します。- 1 つ以上
section
オブジェクト それぞれに 1 つ以上のウィジェットが 含まれています - 1 つ以上
widget
オブジェクト。 各ウィジェットは複合オブジェクトで、テキスト、画像、 ボタン、その他のオブジェクト タイプです。
たとえば、次のカード メッセージには、
header
section
、
widget
オブジェクト:
次のコードは、カード メッセージの 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 用アプリ用の JSON カード メッセージを設計し、プレビューします。
カードビルダーを開く