Cards v1

カード

カードは、テキストや画像などの UI ウィジェットを含むことができる UI 要素です。

JSON 表現 
{
  "header": {
    object (CardHeader)
  },
  "sections": [
    {
      object (Section)
    }
  ],
  "cardActions": [
    {
      object (CardAction)
    }
  ],
  "name": string
}
フィールド
header

object (CardHeader)

カードのヘッダー。ヘッダーには通常、タイトルと画像が含まれます。
sections[]

object (Section)

セクションは分割線で区切ります。
cardActions[]

object (CardAction)

このカードのアクション。

name

string

カードの名前。

CardHeader

JSON 表現 
{
  "title": string,
  "subtitle": string,
  "imageStyle": enum (ImageStyle),
  "imageUrl": string
}
フィールド
title

string

タイトルを指定する必要があります。ヘッダーの高さは固定されています。タイトルとサブタイトルの両方が指定されている場合、それぞれ 1 行を占有します。タイトルのみが指定されている場合、両方の行が使用されます。
subtitle

string

カード ヘッダーのサブタイトル。
imageStyle

enum (ImageStyle)

画像のタイプ（正方形の枠線や円形の枠線など）。
imageUrl

string

カードのヘッダーにある画像の URL。

ImageStyle

列挙型
IMAGE_STYLE_UNSPECIFIED
IMAGE 正方形の枠線。
AVATAR 円形の枠線。

セクション

セクションには、指定された順序で（縦方向に）レンダリングされるウィジェットのコレクションが含まれています。すべてのプラットフォームで、カードの幅は狭く固定されているため、現時点ではレイアウト プロパティ（float など）は必要ありません。

JSON 表現 
{
  "header": string,
  "widgets": [
    {
      object (WidgetMarkup)
    }
  ]
}
フィールド
header

string

セクションのヘッダー。書式設定されたテキストがサポートされています。テキストの書式設定について詳しくは、Google Chat アプリでのテキストの書式設定と Google Workspace アドオンでのテキストの書式設定をご覧ください。
widgets[]

object (WidgetMarkup)

セクションには少なくとも 1 つのウィジェットを含める必要があります。

WidgetMarkup

ウィジェットは、テキストと画像を表示する UI 要素です。

JSON 表現 
{
  "buttons": [
    {
      object (Button)
    }
  ],

  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "keyValue": {
    object (KeyValue)
  }
}
フィールド
buttons[]

object (Button)

ボタンのリスト。Buttons も oneof data であり、これらのフィールドのいずれか 1 つのみを設定する必要があります。
WidgetMarkup には、次のいずれか 1 つの項目のみを指定できます。複数の WidgetMarkup フィールドを使用して、より多くのアイテムを表示できます。以下は、相互に排他的なフィールドのリストです。レスポンスで設定されるフィールドは最大で 1 つです。
textParagraph

object (TextParagraph)

このウィジェットにテキストの段落を表示します。
image

object (Image)

このウィジェットに画像を表示します。
keyValue

object (KeyValue)

このウィジェットに Key-Value の項目を表示します。
相互に排他的なフィールドの終わり。

TextParagraph

テキストの段落。書式設定されたテキストがサポートされています。テキストの書式設定について詳しくは、Google Chat アプリでのテキストの書式設定と Google Workspace アドオンでのテキストの書式設定をご覧ください。

JSON 表現 
{
  "text": string
}
フィールド
text

string

画像

URL で指定された画像。onclick アクションを設定できます。

JSON 表現 
{
  "imageUrl": string,
  "onClick": {
    object (OnClick)
  },
  "aspectRatio": number
}
フィールド
imageUrl

string

画像の URL です。

onClick

object (OnClick)

onclick アクション。
aspectRatio

number

この画像のアスペクト比（幅と高さ）。このフィールドを使用すると、画像の読み込みを待機している間、画像の適切な高さを確保できます。これは、画像の組み込みアスペクト比をオーバーライドするためのものではありません。設定されていない場合、サーバーは画像をプリフェッチしてこの値を入力します。

OnClick

onclick アクション（リンクを開くなど）。

JSON 表現 
{

  "action": {
    object (FormAction)
  },
  "openLink": {
    object (OpenLink)
  }
}
フィールド
以下は、相互に排他的なフィールドのリストです。レスポンスで設定されるフィールドは最大で 1 つです。
action

object (FormAction)

指定されている場合、この onclick アクションによってフォーム アクションがトリガーされます。
相互に排他的なフィールドの終わり。

FormAction

フォーム アクションは、フォームが送信されたときの動作を記述します。たとえば、Apps Script を呼び出してフォームを処理できます。

JSON 表現 
{
  "actionMethodName": string,
  "parameters": [
    {
      object (ActionParameter)
    }
  ]
}
フィールド
actionMethodName

string

メソッド名は、フォームのどの部分がフォームの送信をトリガーしたかを特定するために使用されます。この情報は、カードのクリック イベントの一部として Chat 用アプリにエコーバックされます。共通の動作をトリガーする複数の要素に同じメソッド名を使用できます。
parameters[]

object (ActionParameter)

アクション パラメータのリスト。

ActionParameter

アクション メソッドが呼び出されたときに指定する文字列パラメータのリスト。たとえば、[今すぐスヌーズ]、[1 日スヌーズ]、[来週スヌーズ] の 3 つのスヌーズボタンがあるとします。action method = snooze() を使用して、文字列パラメータのリストでスヌーズ タイプとスヌーズ時間を渡すことができます。

JSON 表現 
{
  "key": string,
  "value": string
}
フィールド
key

string

アクション スクリプトのパラメータの名前。
value

string

パラメータの値。

KeyValue

UI 要素には、キー（ラベル）と値（コンテンツ）が含まれます。この要素には、onclick ボタンなどのアクションを含めることもできます。

JSON 表現 
{
  "topLabel": string,
  "content": string,
  "contentMultiline": boolean,
  "bottomLabel": string,
  "onClick": {
    object (OnClick)
  },

  "icon": enum (Icon),
  "iconUrl": string

  "button": {
    object (Button)
  }
}
フィールド
topLabel

string

上部のラベルのテキスト。書式設定されたテキストがサポートされています。テキストの書式設定について詳しくは、Google Chat アプリでのテキストの書式設定と Google Workspace アドオンでのテキストの書式設定をご覧ください。
content

string

コンテンツのテキスト。書式設定されたテキストがサポートされ、常に必要です。テキストの書式設定について詳しくは、Google Chat アプリでのテキストの書式設定と Google Workspace アドオンでのテキストの書式設定をご覧ください。
contentMultiline

boolean

コンテンツが複数行であるかどうか。
bottomLabel

string

下部のラベルのテキスト。書式設定されたテキストがサポートされています。テキストの書式設定について詳しくは、Google Chat アプリでのテキストの書式設定と Google Workspace アドオンでのテキストの書式設定をご覧ください。
onClick

object (OnClick)

onclick アクション。クリックできるのは、上部のラベル、下部のラベル、コンテンツ領域のみです。
アイコン、top_label、bottom_label のうち少なくとも 1 つを定義する必要があります。以下は、相互に排他的なフィールドのリストです。レスポンスで設定されるフィールドは最大で 1 つです。
icon

enum (Icon)

Chat API によって対応するアイコン画像に置き換えられる列挙型値。
iconUrl

string

URL で指定されたアイコン。

相互に排他的なフィールドの終わり。
コントロール ウィジェット。button または switch_widget のいずれかを設定できますが、両方は設定できません。以下は、相互に排他的なフィールドのリストです。レスポンスで設定されるフィールドは最大で 1 つです。
button

object (Button)

クリックしてアクションをトリガーできるボタン。
相互に排他的なフィールドの終わり。

アイコン

サポートされているアイコンのセット。

列挙型
ICON_UNSPECIFIED
AIRPLANE
BOOKMARK
BUS
CAR
CLOCK
CONFIRMATION_NUMBER_ICON
DOLLAR
DESCRIPTION
EMAIL
EVENT_PERFORMER
EVENT_SEAT
FLIGHT_ARRIVAL
FLIGHT_DEPARTURE
HOTEL
HOTEL_ROOM_TYPE
INVITE
MAP_PIN
MEMBERSHIP
MULTIPLE_PEOPLE
OFFER
PERSON
PHONE
RESTAURANT_ICON
SHOPPING_CART
STAR
STORE
TICKET
TRAIN
VIDEO_CAMERA
VIDEO_PLAY

ボタン

ボタン。テキスト ボタンまたは画像ボタンを指定できます。

JSON 表現 
{

  "textButton": {
    object (TextButton)
  },
  "imageButton": {
    object (ImageButton)
  }
}
フィールド
以下は、相互に排他的なフィールドのリストです。レスポンスで設定されるフィールドは最大で 1 つです。
textButton

object (TextButton)

テキストと onclick アクションを含むボタン。
imageButton

object (ImageButton)

画像と onclick アクションを含むボタン。

相互に排他的なフィールドの終わり。

TextButton

テキストと onclick アクションを含むボタン。

JSON 表現 
{
  "text": string,
  "onClick": {
    object (OnClick)
  }
}
フィールド
text

string

ボタンのテキスト。
onClick

object (OnClick)

ボタンの onclick アクション。

ImageButton

onclick アクションを含む画像ボタン。

JSON 表現 
{
  "onClick": {
    object (OnClick)
  },
  "name": string,

  "icon": enum (Icon),
  "iconUrl": string
}
フィールド
onClick

object (OnClick)

onclick アクション。
name

string

ユーザー補助に使用されるこの imageButton の名前。この名前が指定されていない場合は、デフォルト値が提供されます。
アイコンは、Icon、enum、または URL で指定できます。以下は、相互に排他的なフィールドのリストです。レスポンスで設定されるフィールドは最大で 1 つです。
icon

enum (Icon)

Chat API によって提供されるアイコンへのインデックスである enum によって指定されたアイコン。
iconUrl

string

URL で指定されたアイコン。

相互に排他的なフィールドの終わり。

CardAction

カード アクションは、カードに関連付けられたアクションです。請求書カードの場合、一般的なアクションは、請求書の削除、請求書のメール送信、ブラウザでの請求書のオープンなどです。

Google Chat アプリではサポートされていません。

JSON 表現 
{
  "actionLabel": string,
  "onClick": {
    object (OnClick)
  }
}
フィールド
actionLabel

string

操作メニュー項目に表示されるラベル。
onClick

object (OnClick)

このアクション アイテムの onclick アクション。