Cards v1

{
  "header": {
    object (CardHeader)
  },
  "sections": [
    {
      object (Section)
    }
  ],
  "cardActions": [
    {
      object (CardAction)
    }
  ],
  "name": string
}

object (CardHeader)

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

object (Section)

セクションは改行で区切られます。

object (CardAction)

このカードの動作。

string

カードの名前。

{
  "title": string,
  "subtitle": string,
  "imageStyle": enum (ImageStyle),
  "imageUrl": string
}

string

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

string

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

enum (ImageStyle)

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

string

カードヘッダーの画像の URL。

{
  "header": string,
  "widgets": [
    {
      object (WidgetMarkup)
    }
  ]
}

string

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

object (WidgetMarkup)

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

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

  // Union field data can be only one of the following:
  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "keyValue": {
    object (KeyValue)
  }
  // End of list of possible types for union field data.
}

object (Button)

ボタンのリスト。ボタンも oneof data であり、これらのフィールドのうちの 1 つのみを設定する必要があります。

object (TextParagraph)

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

object (Image)

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

object (KeyValue)

このウィジェットに Key-Value アイテムを表示します。

{
  "text": string
}

string

{
  "imageUrl": string,
  "onClick": {
    object (OnClick)
  },
  "aspectRatio": number
}

string

画像の URL です。

object (OnClick)

onclick アクション。

number

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

{

  // Union field data can be only one of the following:
  "action": {
    object (FormAction)
  },
  "openLink": {
    object (OpenLink)
  }
  // End of list of possible types for union field data.
}

object (FormAction)

フォーム アクションを指定すると、この onclick アクションによってトリガーされます。

object (OpenLink)

この onclick アクションを指定すると、リンクを開くアクションがトリガーされます。

{
  "actionMethodName": string,
  "parameters": [
    {
      object (ActionParameter)
    }
  ]
}

string

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

object (ActionParameter)

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

{
  "key": string,
  "value": string
}

string

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

string

パラメータの値。

{
  "url": string
}

string

開く URL。

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

  // Union field icons can be only one of the following:
  "icon": enum (Icon),
  "iconUrl": string
  // End of list of possible types for union field icons.

  // Union field control can be only one of the following:
  "button": {
    object (Button)
  }
  // End of list of possible types for union field control.
}

string

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

string

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

boolean

コンテンツを複数行にするかどうかを指定します。

string

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

object (OnClick)

onclick アクション。トップラベル、ボトムラベル、コンテンツ領域のみがクリック可能です。

enum (Icon)

Chat API と対応するアイコン画像に置き換えられる列挙値です。

string

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

object (Button)

クリックしてアクションをトリガーできるボタン。

{

  // Union field type can be only one of the following:
  "textButton": {
    object (TextButton)
  },
  "imageButton": {
    object (ImageButton)
  }
  // End of list of possible types for union field type.
}

object (TextButton)

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

object (ImageButton)

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

{
  "text": string,
  "onClick": {
    object (OnClick)
  }
}

string

ボタンのテキスト。

object (OnClick)

ボタンの onclick アクション。

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

  // Union field icons can be only one of the following:
  "icon": enum (Icon),
  "iconUrl": string
  // End of list of possible types for union field icons.
}

object (OnClick)

onclick アクション。

string

ユーザー補助に使用されるこの imageButton の名前。この名前が指定されていない場合は、デフォルト値が提供されます。

enum (Icon)

Chat API が提供するアイコンを示す enum で指定されたアイコン。

string

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

{
  "actionLabel": string,
  "onClick": {
    object (OnClick)
  }
}

string

アクション メニュー項目に表示されるラベル。

object (OnClick)

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