Package google.apps.card.v1

目次

アクション

フォーム送信時の動作を記述するアクション。たとえば、Apps Script のスクリプトを呼び出してフォームを処理できます。アクションがトリガーされると、フォームの値がサーバーに送信されます。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

フィールド
function

string

含まれる要素がクリックされたとき、または他の要素がアクティブになったときに呼び出すカスタム関数。

使用例については、インタラクティブなカードを作成するをご覧ください。

parameters[]

ActionParameter

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

loadIndicator

LoadIndicator

アクションの呼び出し中にアクションが表示する読み込みインジケーターを指定します。

persistValues

bool

フォームの値がアクションの後も保持されるかどうかを示します。デフォルト値は false です。

true の場合、アクションがトリガーされた後もフォームの値が残ります。アクションの処理中にユーザーが変更できるようにするには、LoadIndicatorNONE に設定します。Chat アプリのカード メッセージの場合は、アクションの ResponseTypeUPDATE_MESSAGE に設定し、アクションを含むカードの同じ card_id を使用する必要があります。

false の場合、アクションがトリガーされたときにフォームの値がクリアされます。アクションの処理中にユーザーが変更できないようにするには、LoadIndicatorSPINNER に設定します。

interaction

Interaction

省略可。ダイアログを開く場合は必要です。

ユーザーとのやり取り(カード メッセージのボタンのクリックなど)に対する処理。

指定しない場合、アプリは通常どおり action を実行して(リンクのオープンや関数の実行など)、応答します。

interaction を指定することで、アプリは特別なインタラクティブな方法で応答できます。たとえば、interactionOPEN_DIALOG に設定すると、アプリでダイアログを開くことができます。指定すると、読み込みインジケーターは表示されません。アドオンに指定すると、カード全体が削除され、クライアントには何も表示されません。

Google Chat アプリで利用できますが、Google Workspace アドオンでは利用できません。

ActionParameter

アクション メソッドが呼び出されたときに提供する文字列パラメータのリスト。たとえば、今すぐスヌーズ、1 日だけスヌーズ、来週の 3 つのスヌーズ ボタンを考えてみます。action method = snooze() を使用して、スヌーズの種類と時間を文字列パラメータのリストに渡します。

詳しくは、CommonEventObject をご覧ください。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

フィールド
key

string

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

value

string

パラメータの値。

インタラクション

省略可。ダイアログを開く場合は必要です。

ユーザーとのやり取り(カード メッセージのボタンのクリックなど)に対する処理。

指定しない場合、アプリは通常どおり action を実行して(リンクのオープンや関数の実行など)、応答します。

interaction を指定することで、アプリは特別なインタラクティブな方法で応答できます。たとえば、interactionOPEN_DIALOG に設定すると、アプリでダイアログを開くことができます。

指定すると、読み込みインジケーターは表示されません。アドオンに指定すると、カード全体が削除され、クライアントには何も表示されません。

Google Chat アプリで利用できますが、Google Workspace アドオンでは利用できません。

列挙型
INTERACTION_UNSPECIFIED デフォルト値。action は通常どおり実行されます。
OPEN_DIALOG

ダイアログを開きます。ダイアログは、Chat アプリがユーザーとやり取りする際に使用する、ウィンドウ形式のカードベースのインターフェースです。

カード メッセージのボタンクリックに応答する Chat アプリでのみサポートされます。アドオンに指定すると、カード全体が削除され、クライアントには何も表示されません。

Google Chat アプリで利用できますが、Google Workspace アドオンでは利用できません。

LoadIndicator

アクションの呼び出し中にアクションが表示する読み込みインジケーターを指定します。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

列挙型
SPINNER コンテンツが読み込み中であることを示すスピナーが表示されます。
NONE 何も表示されません。

BorderStyle

カードまたはウィジェットの枠線のスタイル オプション(枠線の種類や色など)。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

フィールド
type

BorderType

枠線の種類。

strokeColor

Color

タイプが BORDER_TYPE_STROKE の場合に使用する色。

cornerRadius

int32

枠線の角の丸み。

BorderType

ウィジェットに適用される枠線の種類を表します。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

列挙型
BORDER_TYPE_UNSPECIFIED 使用しないでください。(指定なし)
NO_BORDER デフォルト値。枠線なし。
STROKE 概要。

ボタン

ユーザーがクリックできるテキスト、アイコン、テキストとアイコンのボタン。Google Chat アプリの例については、ボタンリストをご覧ください。

画像をクリック可能なボタンにするには、ImageImageComponent ではない)を指定し、onClick アクションを設定します。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

フィールド
text

string

ボタン内に表示されるテキスト。

icon

Icon

アイコン画像。icontext の両方を設定した場合は、テキストの前にアイコンが表示されます。

color

Color

設定すると、ボタンは無地の背景色で塗りつぶされ、フォントの色が変化して背景色とのコントラストが維持されます。たとえば、青い背景を設定すると、白いテキストになります。

設定しない場合、画像の背景は白、フォントの色は青になります。

赤、緑、青の場合、各フィールドの値は float の数値です。0 ~ 255 の数値を 255 で割った数値(153÷255)か、0 ~ 1 の値(0.6)のいずれかで表現できます。0 は色がないことを、1(255/255)は RGB スケールでその色が完全に存在することを表します。

必要に応じて alpha を設定します。これは、次の式を使用して透明度を設定します。

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

alpha の場合、1 の値は単色に対応し、0 の値は完全に透明な色に対応します。

たとえば、次の色は半透明の赤を表しています。

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
   "alpha": 0.5
}
onClick

OnClick

必須。ハイパーリンクの表示やカスタム関数の実行など、ユーザーがボタンをクリックしたときに実行するアクション。

disabled

bool

true の場合、ボタンは非アクティブな状態で表示され、ユーザーの操作に反応しません。

altText

string

ユーザー補助に使用される代替テキスト。

ボタンの機能をユーザーに伝える説明テキストを設定します。たとえば、ボタンによってハイパーリンクが開く場合は、「新しいブラウザタブが開き、Google Chat のデベロッパー向けドキュメント(https://developers.google.com/chat")に移動します」と入力します。

ButtonList

横方向にレイアウトされたボタンのリスト。Google Chat アプリの例については、ボタンリストをご覧ください。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

フィールド
buttons[]

Button

ボタンの配列。

カード

Google Chat のメッセージまたは Google Workspace アドオンに表示されているカード インターフェース。

カードでは、定義済みのレイアウト、ボタンなどのインタラクティブな UI 要素、画像などのリッチメディアがサポートされます。カードを使用して詳細情報を表示し、ユーザーから情報を収集して、ユーザーを次のステップに導きます。

カードビルダーでカードをデザインしてプレビューする。

カードビルダーを開く

カードの作成方法については、次のドキュメントをご覧ください。

例: Google Chat アプリのカード メッセージ

連絡先カードの例

Google Chat でサンプルのカード メッセージを作成するには、次の 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"
                             }
                           ]
                         }
                       }
                     }
                   ]
                 }
               }
             ]
           }
         ]
       }
    }
  ]
}
フィールド
header

CardHeader

カードのヘッダー。ヘッダーには通常、先頭の画像とタイトルが含まれます。ヘッダーは常にカードの上部に表示されています。

sections[]

Section

ウィジェットのコレクションが含まれています。各セクションには、独自のオプションのヘッダーがあります。セクションは線の区切りで視覚的に区切られています。Google Chat アプリの例については、カード セクションをご覧ください。

sectionDividerStyle

DividerStyle

セクション間の分割線。

cardActions[]

CardAction

カードの操作。操作はカードのツールバー メニューに追加されます。

Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。

たとえば、次の JSON は、Settings オプションと Send Feedback オプションを含むカード アクション メニューを構築します。

"cardActions": [
  {
    "actionLabel": "Settings",
    "onClick": {
      "action": {
        "functionName": "goToView",
        "parameters": [
          {
            "key": "viewType",
            "value": "SETTING"
         }
        ],
        "loadIndicator": "LoadIndicator.SPINNER"
      }
    }
  },
  {
    "actionLabel": "Send Feedback",
    "onClick": {
      "openLink": {
        "url": "https://example.com/feedback"
      }
    }
  }
]
name

string

カードの名前。カード ナビゲーションでカード ID として使用されます。

Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。

fixedFooter

CardFixedFooter

このカードの下部に表示される固定フッター。

primaryButton または secondaryButton を指定せずに fixedFooter を設定すると、エラーが発生します。Chat アプリでは、ダイアログに固定のフッターを使用できますが、カード メッセージでは使用できません。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

displayStyle

DisplayStyle

Google Workspace アドオンで、peekCardHeader の表示プロパティを設定します。

Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。

peekCardHeader

CardHeader

コンテキスト コンテンツを表示する際、ピークカード ヘッダーはプレースホルダの役割を果たし、ユーザーはホームページ カードとコンテキスト カード間を移動できます。

Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。

CardAction

カード アクションとは、カードに関連付けられているアクションのことです。たとえば、請求書カードには、請求書を削除する、請求書をメールで送信する、ブラウザで請求書を開くなどのアクションを含めることができます。

Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。

フィールド
actionLabel

string

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

onClick

OnClick

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

CardFixedFooter

カードの下部に表示される固定された(固定の)フッター。

primaryButton または secondaryButton を指定せずに fixedFooter を設定すると、エラーが発生します。

Chat アプリでは、ダイアログに固定のフッターを使用できますが、カード メッセージでは使用できません。Google Chat アプリの例については、カードフッターをご覧ください。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

フィールド
primaryButton

Button

固定フッターのメインボタン。ボタンは、テキストと色を設定したテキストボタンにする必要があります。

secondaryButton

Button

固定フッターのセカンダリ ボタン。ボタンは、テキストと色を設定したテキストボタンにする必要があります。secondaryButton が設定されている場合は、primaryButton も設定する必要があります。

CardHeader

カードヘッダーを表します。Google Chat アプリの例については、カードヘッダーをご覧ください。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

フィールド
title

string

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

subtitle

string

カードヘッダーのサブタイトル。指定すると、title の下に単独の行に表示されます。

imageType

ImageType

画像の切り抜きに使用する形状。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

imageUrl

string

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

imageAltText

string

ユーザー補助に使用される、この画像の代替テキスト。

DisplayStyle

Google Workspace アドオンでは、カードの表示方法を決定します。

Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。

列挙型
DISPLAY_STYLE_UNSPECIFIED 使用しないでください。(指定なし)
PEEK カードのヘッダーはサイドバーの下部に表示され、スタックの現在の一番上のカードの一部の上に重ねて表示されます。ヘッダーをクリックすると、カードがカードスタックにポップされます。カードにヘッダーがない場合は、生成されたヘッダーが代わりに使用されます。
REPLACE デフォルト値。カードスタック内の一番上のカードのビューを置き換えることで、カードが表示されます。

DividerStyle

カードの分割線スタイル。現時点では、カード セクション間の分割線にのみ使用されます。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

列挙型
DIVIDER_STYLE_UNSPECIFIED 使用しないでください。(指定なし)
SOLID_DIVIDER デフォルトのオプション。セクション間の強固な分割線をレンダリングします。
NO_DIVIDER 設定すると、セクション間の分割線はレンダリングされません。

セクション

1 つのセクションには、指定された順序で垂直方向にレンダリングされるウィジェットのコレクションが含まれます。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

フィールド
header

string

セクションの上部に表示されるテキスト。シンプルな HTML 形式のテキストをサポートします。テキストの書式設定について詳しくは、Google Chat アプリでのテキストの書式設定Google Workspace アドオンでのテキストの書式設定をご覧ください。

widgets[]

Widget

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

collapsible

bool

このセクションが折りたたみ可能かどうかを示します。

折りたたみ可能なセクションでは、一部またはすべてのウィジェットが非表示になりますが、[もっと見る] をクリックすると、セクションを展開して非表示のウィジェットを表示できます。[一部を表示] をクリックすると、ウィジェットを再度非表示にできます。

非表示にするウィジェットを指定するには、uncollapsibleWidgetsCount を指定します。

uncollapsibleWidgetsCount

int32

セクションを折りたたんでも表示されている折りたたみできないウィジェットの数。

たとえば、セクションに 5 つのウィジェットがあり、uncollapsibleWidgetsCount2 に設定されている場合、最初の 2 つのウィジェットは常に表示され、最後の 3 つのウィジェットはデフォルトで折りたたまれています。uncollapsibleWidgetsCount は、collapsibletrue の場合にのみ考慮されます。

表示項目

Columns ウィジェットでは、カードまたはダイアログに最大 2 列が表示されます。各列にウィジェットを追加できます。ウィジェットは指定された順序で表示されます。Google Chat アプリの例については、をご覧ください。

各列の高さは、背の高い列によって決まります。たとえば、最初の列が 2 番目の列よりも高い場合、どちらの列も最初の列の高さになります。各列に含めることができるウィジェットの数は異なるため、行を定義したり、列間でウィジェットを配置したりすることはできません。

列は並べて表示されます。各列の幅は HorizontalSizeStyle フィールドを使用してカスタマイズできます。ユーザーの画面幅が小さすぎる場合、2 番目の列は 1 番目の列より下に折り返されます。

  • ウェブでは、画面幅が 480 ピクセル以下の場合、2 列目が折り返されます。
  • iOS デバイスでは、画面の幅が 300 pt 以下の場合、2 列目が折り返されます。
  • Android デバイスでは、画面幅が 320 dp 以下の場合、2 列目が折り返されます。

3 つ以上の列を含める、または行を使用する場合は、Grid ウィジェットを使用します。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。Google Workspace アドオンの列はデベロッパー プレビューです。

フィールド
columnItems[]

Column

列の配列。カードまたはダイアログには最大 2 列を含めることができます。

列。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。Google Workspace アドオンの列はデベロッパー プレビューです。

フィールド
horizontalSizeStyle

HorizontalSizeStyle

カードの幅を列で埋める方法を指定します。

horizontalAlignment

HorizontalAlignment

ウィジェットを列の左、右、中央に揃えるかどうかを指定します。

verticalAlignment

VerticalAlignment

ウィジェットを列の上部、下部、または中央に配置するかどうかを指定します。

widgets[]

Widgets

列に含まれるウィジェットの配列。ウィジェットは指定された順序で表示されます。

HorizontalSizeStyle

カードの幅を列で埋める方法を指定します。各列の幅は、HorizontalSizeStyle と、列内のウィジェットの幅の両方に依存します。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。Google Workspace アドオンの列はデベロッパー プレビューです。

列挙型
HORIZONTAL_SIZE_STYLE_UNSPECIFIED 使用しないでください。(指定なし)
FILL_AVAILABLE_SPACE デフォルト値。列は利用可能なスペース(カードの幅の 70% まで)全体に表示されます。両方の列が FILL_AVAILABLE_SPACE に設定されている場合、各列がスペースの 50% を占めます。
FILL_MINIMUM_SPACE 列が占めるスペースは最小であり、カードの幅の 30% 以下であること。

VerticalAlignment

ウィジェットを列の上部、下部、または中央に配置するかどうかを指定します。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。Google Workspace アドオンの列はデベロッパー プレビューです。

列挙型
VERTICAL_ALIGNMENT_UNSPECIFIED 使用しないでください。(指定なし)
CENTER デフォルト値。ウィジェットを列の中央に揃えます。
TOP ウィジェットを列の上部に配置します。
BOTTOM ウィジェットを列の下部に揃えます。

ウィジェット

列に含めることができる、サポートされているウィジェット。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。Google Workspace アドオンの列はデベロッパー プレビューです。

フィールド

共用体フィールド data

data は次のいずれかになります。

textParagraph

TextParagraph

TextParagraphウィジェットです。

image

Image

Imageウィジェットです。

decoratedText

DecoratedText

DecoratedTextウィジェットです。

buttonList

ButtonList

ButtonListウィジェットです。

textInput

TextInput

TextInputウィジェットです。

selectionInput

SelectionInput

SelectionInputウィジェットです。

dateTimePicker

DateTimePicker

DateTimePickerウィジェットです。

DateTimePicker

日付、時刻、またはその両方を入力できます。Google Chat アプリの例については、日時選択ツールをご覧ください。

ユーザーはテキストを入力するか、選択ツールを使用して日付と時刻を選択できます。ユーザーが無効な日時を入力した場合、選択ツールにエラーが表示され、ユーザーに情報を正しく入力するよう促します。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

フィールド
name

string

フォーム入力イベントで DateTimePicker を識別する名前。

フォーム入力の操作について詳しくは、フォームデータを受信するをご覧ください。

label

string

日付、時刻、または日時の入力を求めるテキスト。たとえば、ユーザーが予約を設定する場合は、「Appointment date」や「Appointment date and time」などのラベルを使用します。

type

DateTimePickerType

ウィジェットが日付、時刻、または日付と時刻の入力をサポートしているかどうか。

valueMsEpoch

int64

ウィジェットに表示されるデフォルト値(Unix エポック時間からのミリ秒数)。

選択ツールのタイプ(DateTimePickerType)に基づいて値を指定します。

  • DATE_AND_TIME: カレンダーの日付と時刻(UTC)。たとえば、2023 年 1 月 1 日午後 12 時(UTC)を表すには、1672574400000 を使用します。
  • DATE_ONLY: カレンダーの日付(00:00:00 UTC)。たとえば、2023 年 1 月 1 日を表すには、1672531200000 を使用します。
  • TIME_ONLY: UTC の時間。たとえば、午後 12 時を表すには、43200000(または 12 * 60 * 60 * 1000)を使用します。
timezoneOffsetDate

int32

UTC からのタイムゾーン オフセットを表す数値(分単位)。設定すると、value_ms_epoch は指定されたタイムゾーンで表示されます。設定しない場合、値はデフォルトでユーザーのタイムゾーン設定になります。

onChangeAction

Action

ユーザーが DateTimePicker インターフェースから [保存] または [消去] をクリックするとトリガーされます。

DateTimePickerType

DateTimePicker ウィジェットの日付と時刻の形式。ユーザーが日付、時刻、または日付と時刻の両方を入力できるようにするかどうかを指定します。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

列挙型
DATE_AND_TIME ユーザーが日時を入力します。
DATE_ONLY ユーザーが日付を入力します。
TIME_ONLY ユーザーが時刻を入力します。

DecoratedText

テキストの上または下にラベル、テキストの前にアイコン、選択ウィジェット、テキストの後にボタンなど、オプションの装飾を付けてテキストを表示するウィジェット。Google Chat アプリの例については、装飾テキストをご覧ください。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

フィールド
icon
(deprecated)

Icon

非推奨になり、startIcon に置き換えられました。

startIcon

Icon

テキストの前に表示されるアイコン。

topLabel

string

text の上に表示されるテキスト。常に切り捨てられます。

text

string

必須。メインのテキスト。

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

wrapText

bool

テキストの折り返しの設定。true の場合、テキストは折り返されて複数の行に表示されます。それ以外の場合、テキストは切り捨てられます。

text にのみ適用されます。topLabelbottomLabel には適用されません。

bottomLabel

string

text の下に表示されるテキスト。常に折り返す。

onClick

OnClick

このアクションは、ユーザーが topLabel または bottomLabel をクリックするとトリガーされます。

共用体フィールド controldecoratedText ウィジェットのテキストの右側に表示されるボタン、スイッチ、チェックボックス、または画像。control は次のいずれかになります。
button

Button

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

switchControl

SwitchControl

ユーザーがクリックすると、状態を変更し、アクションをトリガーできる switch ウィジェットです。

endIcon

Icon

テキストの後に表示されるアイコン。

組み込みアイコンとカスタム アイコンをサポートします。

SwitchControl

切り替えスタイルのスイッチ、または decoratedText ウィジェット内のチェックボックス。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

decoratedText ウィジェットでのみサポートされます。

フィールド
name

string

フォーム入力イベントで switch ウィジェットを識別するための名前。

フォーム入力の操作について詳しくは、フォームデータを受信するをご覧ください。

value

string

ユーザーが入力した値。フォーム入力イベントの一部として返されます。

フォーム入力の操作について詳しくは、フォームデータを受信するをご覧ください。

selected

bool

true の場合は、スイッチが選択されます。

onChangeAction

Action

スイッチの状態が変更されたときに実行するアクション(実行する関数など)。

controlType

ControlType

ユーザー インターフェースにスイッチがどのように表示されるか。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

ControlType

ユーザー インターフェースにスイッチがどのように表示されるか。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

列挙型
SWITCH 切り替えスタイルのスイッチ。
CHECKBOX 非推奨になり、CHECK_BOX に置き換えられました。
CHECK_BOX チェックボックス。

分割線

このタイプにはフィールドがありません。

ウィジェット間の分割線を水平線で表示します。Google Chat アプリの例については、分割線をご覧ください。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

たとえば、次の JSON は分割線を作成します。

"divider": {}

EndNavigation

ダイアログ フロー アクション。

Google Chat アプリで利用できますが、Google Workspace アドオンでは利用できません。

フィールド
action

Action

クライアントがダイアログ フローを終了するためのレンダリング アクション。

Google Chat アプリで利用できますが、Google Workspace アドオンでは利用できません。

アクション

クライアントがダイアログ フローを終了するレンダリング アクション タイプ。

Google Chat アプリで利用できますが、Google Workspace アドオンでは利用できません。

列挙型
ACTION_UNSPECIFIED アクションが指定されていません。
CLOSE_DIALOG ダイアログ フローを閉じます。
CLOSE_DIALOG_AND_EXECUTE ダイアログ フローを閉じて、ダイアログ フローを開いたカードを更新します。

GetAutocompletionResponse

オートコンプリート コンテナの取得に対するレスポンス。テキスト フィールドのオートコンプリート アイテムを表示するために必要な要素が含まれています。

Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。次に例を示します。

{
  "autoComplete": {
    "items": [
      {
        "text": "C++"
      },
      {
        "text": "Java"
      },
      {
        "text": "JavaScript"
      },
      {
        "text": "Python"
      }
    ]
  }
}
フィールド
autoComplete

Suggestions

schema

string

これは、構文チェックのためにマークアップに存在する可能性がある NoOps スキーマ フィールドです。

GRid

アイテムのコレクションをグリッドに表示します。アイテムに含めることができるのは、テキストまたは画像のみです。レスポンシブ列の場合、またはテキストや画像以外の要素を含める場合は、Columns を使用します。Google Chat アプリの例については、グリッドをご覧ください。

グリッドは任意の数の列とアイテムをサポートします。行数は、項目を列数で割った値です。2 つの列に 10 個の項目があるグリッドには 5 行あります。11 個の項目と 2 列のグリッドには 6 行あります。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

たとえば、次の JSON は 1 つのアイテムを含む 2 列のグリッドを作成します。

"grid": {
  "title": "A fine collection of items",
  "columnCount": 2,
  "borderStyle": {
    "type": "STROKE",
    "cornerRadius": 4
  },
  "items": [
    {
      "image": {
        "imageUri": "https://www.example.com/image.png",
        "cropStyle": {
          "type": "SQUARE"
        },
        "borderStyle": {
          "type": "STROKE"
        }
      },
      "title": "An item",
      "textAlignment": "CENTER"
    }
  ],
  "onClick": {
    "openLink": {
      "url": "https://www.example.com"
    }
  }
}
フィールド
title

string

グリッドのヘッダーに表示されるテキスト。

items[]

GridItem

グリッドに表示するアイテム。

borderStyle

BorderStyle

各グリッド アイテムに適用する枠線のスタイル。

columnCount

int32

グリッドに表示する列数です。このフィールドが指定されていない場合はデフォルト値が使用されます。デフォルト値は、グリッドが表示される場所(ダイアログまたはコンパニオン)によって異なります。

onClick

OnClick

このコールバックは、個々のグリッド アイテムで再利用されますが、アイテムリストのアイテムの識別子とインデックスがコールバックのパラメータに追加されます。

GridItem

グリッド レイアウトのアイテムを表します。アイテムには、テキスト、画像、またはテキストと画像の両方を含めることができます。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

フィールド
id

string

このグリッド アイテムのユーザー指定の識別子。この識別子は、親グリッドの onClick コールバック パラメータで返されます。

image

ImageComponent

グリッド アイテムに表示される画像。

title

string

グリッド アイテムのタイトル。

subtitle

string

グリッド アイテムのサブタイトル。

layout

GridItemLayout

グリッド アイテムに使用するレイアウト。

GridItemLayout

グリッド アイテムで利用可能なさまざまなレイアウト オプションを表します。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

列挙型
GRID_ITEM_LAYOUT_UNSPECIFIED 使用しないでください。(指定なし)
TEXT_BELOW タイトルとサブタイトルは、グリッド アイテムの画像の下に表示されます。
TEXT_ABOVE タイトルとサブタイトルは、グリッド アイテムの画像の上に表示されます。

Icon

カード上のウィジェットに表示されるアイコン。Google Chat アプリの例については、アイコンをご覧ください。

組み込みアイコンとカスタム アイコンをサポートします。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

フィールド
altText

string

省略可。ユーザー補助に使用されるアイコンの説明。指定しない場合は、デフォルト値の Button が指定されます。ベスト プラクティスとして、アイコンの表示内容と、アイコンの機能(該当する場合)に関するわかりやすい説明を設定することをおすすめします。例: A user's account portrait、または Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/chat

アイコンが Button に設定されている場合、ユーザーがボタンにカーソルを合わせると、altText がヘルパー テキストとして表示されます。ただし、ボタンで text も設定した場合、アイコンの altText は無視されます。

imageType

ImageType

画像に適用される切り抜きスタイル。CIRCLE 切り抜きを適用すると、画像が組み込みのアイコンよりも大きく表示される場合があります。

共用体フィールド icons。カード上のウィジェットに表示されるアイコン。icons は次のいずれかになります。
knownIcon

string

Google Workspace に組み込まれているアイコンのいずれかを表示します。

たとえば、飛行機アイコンを表示するには、AIRPLANE を指定します。バスの場合は、BUS を指定します。

サポートされているアイコンの完全なリストについては、組み込みアイコンをご覧ください。

iconUrl

string

HTTPS URL でホストされているカスタム アイコンを表示します。

次に例を示します。

"iconUrl":
"https://developers.google.com/chat/images/quickstart-app-avatar.png"

サポートされているファイル形式は .png.jpg です。

materialIcon

MaterialIcon

Google マテリアル アイコンのいずれかを表示します。

たとえば、チェックボックス アイコンを表示するには、次のコマンドを使用します。

"materialIcon": {
  "name": "check_box"
}

Google Chat アプリで利用できますが、Google Workspace アドオンでは利用できません。

画像

URL で指定される画像。onClick アクションを設定できます。例については、イメージをご覧ください。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

フィールド
imageUrl

string

イメージをホストする HTTPS URL。

次に例を示します。

https://developers.google.com/chat/images/quickstart-app-avatar.png
onClick

OnClick

ユーザーが画像をクリックすると、このアクションがトリガーされます。

altText

string

ユーザー補助に使用される、この画像の代替テキスト。

ImageComponent

画像を表します。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

フィールド
imageUri

string

画像の URL。

altText

string

画像のユーザー補助ラベル。

cropStyle

ImageCropStyle

画像に適用する切り抜きスタイル。

borderStyle

BorderStyle

画像に適用する枠線のスタイル。

ImageCropStyle

画像に適用される切り抜きスタイルを表します。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

たとえば、16:9 のアスペクト比を適用する方法は次のとおりです。

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}
フィールド
type

ImageCropType

切り抜きタイプ。

aspectRatio

double

切り抜きタイプが RECTANGLE_CUSTOM の場合に使用するアスペクト比。

たとえば、16:9 のアスペクト比を適用する方法は次のとおりです。

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}

ImageCropType

画像に適用される切り抜きスタイルを表します。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

列挙型
IMAGE_CROP_TYPE_UNSPECIFIED 使用しないでください。(指定なし)
SQUARE デフォルト値。正方形に切り抜きを適用します。
CIRCLE 円形に切り抜きを適用します。
RECTANGLE_CUSTOM カスタム アスペクト比で長方形の切り抜きを適用します。aspectRatio でカスタム アスペクト比を設定します。
RECTANGLE_4_3 アスペクト比 4:3 の長方形の切り抜きを適用します。

LinkPreview

カードとスマートチップを表示して第三者リンクをプレビューするカード アクション。詳しくは、スマートチップを使用してリンクをプレビューするをご覧ください。

Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。

たとえば、次の JSON は、リンク プレビューとそのスマートチップの一意のタイトルと、ヘッダーとテキストの説明を含むプレビュー カードを返します。

{
  "action": {
    "linkPreview": {
      "title": "Smart chip title",
      "linkPreviewTitle": "Link preview title",
      "previewCard": {
        "header": {
          "title": "Preview card header",
        },
        "sections": [
          {
            "widgets": [
              {
                "textParagraph": {
                  "text": "Description of the link."
                }
              }
            ]
          }
        ]
      }
    }
  }
}

この例では、次のリンク プレビューが返されます。

リンク プレビューの例

フィールド
previewCard

Card

第三者サービスからのリンクに関する情報を表示するカード。

title

string

リンク プレビューのスマートチップに表示されるタイトル。設定しない場合、スマートチップは preview_cardヘッダーを表示します。

linkPreviewTitle

string

リンク プレビューに表示されるタイトル。設定しない場合、リンク プレビューには preview_cardヘッダーが表示されます。

MaterialIcon

Google マテリアル アイコン: 2, 500 以上のオプションが含まれています。

たとえば、カスタマイズされた体重と成績のチェックボックス アイコンを表示するには、次のように記述します。

{
  "name": "check_box",
  "fill": true,
  "weight": 300,
  "grade": -25
}

Google Chat アプリで利用できますが、Google Workspace アドオンでは利用できません。

フィールド
name

string

Google マテリアル アイコンで定義されたアイコン名(例: check_box)。無効な名前は破棄され、空の文字列で置き換えられます。その結果、アイコンはレンダリングされなくなります。

fill

bool

アイコンが塗りつぶされた状態でレンダリングされるかどうか。デフォルト値は false です。

さまざまなアイコン設定をプレビューするには、[Google Font Icons] に移動し、[カスタマイズ] で設定を調整します。

weight

int32

アイコンのストロークの太さ。{100、200、300、400、500、600、700} から選択できます。指定されていない場合、デフォルト値は 400 です。他の値を指定すると、デフォルト値が使用されます。

さまざまなアイコン設定をプレビューするには、[Google Font Icons] に移動し、[カスタマイズ] で設定を調整します。

grade

int32

重量とグレードはシンボルの太さに影響します。グレードの調整は、太さの調整よりも細かい粒度で、記号のサイズへの影響は小さくなります。{-25, 0, 200} から選択できます。指定されていない場合、デフォルト値は 0 です。他の値を指定すると、デフォルト値が使用されます。

さまざまなアイコン設定をプレビューするには、[Google Font Icons] に移動し、[カスタマイズ] で設定を調整します。

カードスタックを操作するカード アクション。

Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。

次に例を示します。

1)新しいカードをスタックに追加する(次に進む)。

 navigations : {
    pushCard : CARD
  }

2)スタックの上でカードを更新します(インプレース更新)。

  navigations : {
    popCard : true,
  }, {
    pushCard : CARD
  }

3)更新せずに 1 つ前のステップに戻ります。

  navigations : {
    popCard : true,
  }

4)複数のステップに戻って、該当するカードを更新する。

  navigations : {
    popCard : true,
  }, ... {
    pushCard : CARD
  }

5)定義された CARD_NAME に複数のステップに戻ります。

  navigations : {
    popToCardName : CARD_NAME,
  }, {
    pushCard : CARD
  }

6)ルートに戻って、そのカードを更新します。

  navigations : {
    popToRoot : true
  }, {
    pushCard : CARD
  }

7)指定したカードまでポップして、そのカードもポップします。

navigations : { popToCardName : CARD_NAME }, { popCard : true, }

8)一番上のカードを新しいカードに置き換える。

  navigations : {
    updateCard : CARD
  }
フィールド

共用体フィールド navigate_action

navigate_action は次のいずれかになります。

popToRoot

bool

カードスタックが、ルートカードを除くすべてのカードからポップされます。

pop

bool

カードスタックが 1 枚はがっている。

popToCard

string

カードスタックは、指定されたカード名を持つ指定されたカードの上にあるすべてのカードをポップします。

pushCard

Card

カードスタックは、カードをカードスタックにプッシュします。

updateCard

Card

カードスタックは、一番上のカードを新しいカードで更新し、入力済みのフォーム フィールドの値を保持します。等価でないフィールドの場合、値は破棄されます。

endNavigation

EndNavigation

ダイアログ フローの終了ナビゲーション アクション。詳しくは、アプリのホームカード メッセージのダイアログに応答するをご覧ください。

Google Chat アプリで利用できますが、Google Workspace アドオンでは利用できません。

通知

ホストアプリに通知を表示するカード アクション。

Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。

フィールド
text

string

通知に表示する書式なしテキスト(HTML タグなし)。

OnClick

ユーザーがカードのインタラクティブな要素(ボタンなど)をクリックしたときに応答する方法を表します。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

フィールド

共用体フィールド data

data は次のいずれかになります。

action

Action

指定すると、この onClick によってアクションがトリガーされます。

openDynamicLinkAction

Action

アクションでリンクを開く必要がある場合、アドオンによってこのアクションがトリガーされます。これは、リンクを取得するためにサーバーと通信する必要があるという点で、上記の open_link とは異なります。そのため、リンクを開くアクション レスポンスが返される前に、ウェブ クライアントでなんらかの準備作業を行う必要があります。

Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。

card

Card

新しいカードは、指定された場合、クリックした後にカードスタックにプッシュされます。

Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。

OnClose

OnClick アクションによって開かれたリンクが閉じられたときのクライアントの動作。

実装はクライアント プラットフォームの機能によって異なります。たとえば、ウェブブラウザが OnClose ハンドラでポップアップ ウィンドウでリンクを開く場合があります。

OnOpen ハンドラと OnClose ハンドラの両方が設定され、クライアント プラットフォームが両方の値をサポートできない場合は、OnClose が優先されます。

Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。

列挙型
NOTHING デフォルト値。カードは再読み込みされず、何も起こりません。
RELOAD

子ウィンドウが閉じた後にカードを再読み込みします。

OpenAs.OVERLAY と併用すると、子ウィンドウはモーダル ダイアログとして機能し、子ウィンドウが閉じるまで親カードはブロックされます。

OpenAs

OnClick アクションでリンクが開くと、クライアントはそのリンクをフルサイズのウィンドウ(クライアントが使用するフレームの場合)またはオーバーレイ(ポップアップなど)として開くことができます。実装はクライアント プラットフォームの機能に依存し、クライアントがサポートしていない場合、選択した値が無視されることがあります。FULL_SIZE はすべてのクライアントでサポートされています。

Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。

列挙型
FULL_SIZE フルサイズ ウィンドウとしてリンクが開きます(クライアントで使用されているフレームの場合)。
OVERLAY ポップアップなどのオーバーレイとしてリンクが開きます。

RenderActions

カードにアクションの実行を指示する、またはアドオン ホストアプリまたは Chat アプリにアプリ固有のアクションを実行するよう指示する、レンダリングの手順のセット。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

フィールド
action

Action

hostAppAction

HostAppActionMarkup

個々のホストアプリによって処理されるアクション。

schema

string

これは、構文チェックのためにマークアップに存在する可能性がある NoOps スキーマ フィールドです。

アクション

フィールド
navigations[]

Navigation

表示されたカードのプッシュ、ポップ、更新を行います。

notification

Notification

エンドユーザーに通知を表示します。

linkPreview

LinkPreview

エンドユーザーにリンク プレビューを表示します。

SelectionInput

ユーザーが選択できる 1 つ以上の UI アイテムを作成するウィジェット。たとえば、プルダウン メニューやチェックボックスなどです。このウィジェットを使用して、予測または列挙が可能なデータを収集できます。Google Chat アプリの例については、選択入力をご覧ください。

チャットアプリは、ユーザーが選択または入力したアイテムの価値を処理できます。フォーム入力の操作について詳しくは、フォームデータを受信するをご覧ください。

未定義のデータまたは抽象データをユーザーから収集するには、TextInput ウィジェットを使用します。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

フィールド
name

string

フォーム入力イベントで選択入力を識別する名前。

フォーム入力の操作について詳しくは、フォームデータを受信するをご覧ください。

label

string

ユーザー インターフェースの選択入力フィールドの上に表示されるテキスト。

ユーザーがアプリに必要な情報を入力するのに役立つテキストを指定します。たとえば、ユーザーがプルダウン メニューからワークチケットの緊急度を選択する場合、ラベルは [緊急度] または [緊急性を選択] になります。

type

SelectionType

SelectionInput ウィジェットでユーザーに表示されるアイテムのタイプ。選択タイプは、さまざまな種類の操作をサポートしています。たとえば、ユーザーは 1 つ以上のチェックボックスをオンにできますが、プルダウン メニューから選択できる値は 1 つのみです。

items[]

SelectionItem

選択可能なアイテムの配列。たとえば、ラジオボタンやチェックボックスの配列などです。最大 100 個のアイテムがサポートされます。

onChangeAction

Action

指定すると、選択が変更されたときにフォームが送信されます。指定しない場合は、フォームを送信する個別のボタンを指定する必要があります。

フォーム入力の操作について詳しくは、フォームデータを受信するをご覧ください。

multiSelectMaxSelectedItems

int32

複数選択メニューの場合、ユーザーが選択できるアイテムの最大数。最小値は 1 アイテムです。指定しない場合のデフォルトは 3 アイテムです。

multiSelectMinQueryLength

int32

複数選択メニューの場合、アプリがクエリする前にユーザーが入力するテキスト文字数がオートコンプリートされ、メニューに候補が表示されます。

指定しない場合、デフォルトで静的データソースの場合は 0 文字、外部データソースの場合は 3 文字になります。

共用体フィールド multi_select_data_source。複数選択メニューの場合、選択項目に入力されるデータソース。

Google Chat アプリで利用できますが、Google Workspace アドオンでは利用できません。multi_select_data_source は次のいずれかになります。

externalDataSource

Action

リレーショナル データベースなどの外部データソース。

platformDataSource

PlatformDataSource

Google Workspace のデータソース。

PlatformDataSource

複数選択メニューを使用する SelectionInput ウィジェットの場合、Google Workspace のデータソース。複数選択メニューの項目を入力するために使用します。

Google Chat アプリで利用できますが、Google Workspace アドオンでは利用できません。

フィールド
共用体フィールド data_source。データソース。data_source は次のいずれかになります。
commonDataSource

CommonDataSource

Google Workspace 組織内のユーザーなど、すべての Google Workspace アプリケーションで共有されるデータソース。

hostAppDataSource

HostAppDataSourceMarkup

Google Chat のスペースなど、Google Workspace ホスト アプリケーションに固有のデータソース。

CommonDataSource

すべての Google Workspace アプリケーションで共有されるデータソース。

Google Chat アプリで利用できますが、Google Workspace アドオンでは利用できません。

列挙型
UNKNOWN デフォルト値。使用しないでください。
USER Google Workspace ユーザー。Google Workspace 組織内のユーザーを表示、選択することのみ可能です。

SelectionItem

チェックボックスやスイッチなど、ユーザーが選択入力で選択できる項目。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

フィールド
text

string

ユーザーにアイテムを識別または説明するテキスト。

value

string

このアイテムに関連付けられた値。クライアントはこれをフォームの入力値として使用する必要があります。

フォーム入力の操作について詳しくは、フォームデータを受信するをご覧ください。

selected

bool

デフォルトでアイテムが選択されるかどうか。選択入力で 1 つの値しか受け入れられない場合(ラジオボタンやプルダウン メニューなど)、このフィールドは 1 つのアイテムにのみ設定します。

startIconUri

string

複数選択メニューの場合、アイテムの text フィールドの横に表示されるアイコンの URL。PNG ファイルと JPEG ファイルを使用できます。HTTPS の URL を指定する必要があります。例: https://developers.google.com/chat/images/quickstart-app-avatar.png

bottomText

string

複数選択メニューの場合、アイテムの text フィールドの下に表示されるテキストの説明またはラベル。

SelectionType

ユーザーが選択できるアイテムの形式。使用できる操作の種類は、オプションによって異なります。たとえば、ユーザーは複数のチェックボックスをオンにできるが、プルダウン メニューから選択できるアイテムは 1 つのみです。

各選択入力では、1 種類の選択がサポートされます。たとえば、チェックボックスとスイッチを組み合わせることはできません。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

列挙型
CHECK_BOX チェックボックスのセット。ユーザーは 1 つ以上のチェックボックスをオンにすることができます。
RADIO_BUTTON ラジオボタンのセット。ユーザーはラジオボタンを 1 つ選択できます。
SWITCH スイッチのセット。ユーザーは 1 つ以上のスイッチをオンにできます。
DROPDOWN プルダウン メニュー。ユーザーはメニューから 1 つのアイテムを選択できます。
MULTI_SELECT

静的データまたは動的データの複数選択メニュー。ユーザーはメニューバーから 1 つ以上のアイテムを選択します。ユーザーは、動的データに値を入力することもできます。たとえば、ユーザーが Google Chat スペースの名前を入力し始めると、ウィジェットが自動的にスペースの候補を表示します。

複数選択メニューの項目にデータを入力するには、次のいずれかのタイプのデータソースを使用します。

  • 静的データ: アイテムはウィジェットで SelectionItem オブジェクトとして指定されます。最大 100 個。
  • Google Workspace のデータ: アイテムは、Google Workspace ユーザーや Google Chat スペースなどの Google Workspace のデータを使用して入力されます。
  • 外部データ: アイテムは Google Workspace の外部の外部データソースから入力されます。

複数選択メニューの実装方法の例については、SelectionInput ウィジェットのページをご覧ください。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。Google Workspace アドオンの複数選択はデベロッパー プレビュー版です。

SubmitFormResponse

オートコンプリート コンテナの取得以外のフォーム送信に対するレスポンス。カードが実行すべきアクションやアドオン ホストアプリが実行するアクション、カードの状態が変更されたかどうかの情報が含まれています。

Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。次に例を示します。

{
  "renderActions": {
    "action": {
      "notification": {
        "text": "Email address is added: salam.heba@example.com"
      }
    },
    "hostAppAction": {
      "gmailAction": {
        "openCreatedDraftAction": {
          "draftId": "msg-a:r-79766936926021702",
          "threadServerPermId": "thread-f:15700999851086004"
        }
      }
    }
  }
}
フィールド
renderActions

RenderActions

カードにアクションの実行を指示する、またはアドオン ホストアプリにアプリ固有のアクションを実行するよう指示する、レンダリング命令のセット。

stateChanged

bool

カードの状態が変更されたかどうか、既存のカードのデータが古くなっているかどうか。

schema

string

これは、構文チェックのためにマークアップに存在する可能性がある NoOps スキーマ フィールドです。

候補

ユーザーが入力できる推奨値。これらの値は、ユーザーがテキスト入力フィールドの中をクリックすると表示されます。ユーザーが入力を始めると、入力内容に応じて推奨値が動的にフィルタされます。

たとえば、プログラミング言語のテキスト入力フィールドには、Java、JavaScript、Python、C++ の候補が表示されます。ユーザーが Jav の入力を開始すると、候補のリストが JavaJavaScript を表示するようにフィルタします。

推奨値は、ユーザーがアプリで理解できる値をユーザーが入力できるようにするのに役立ちます。JavaScript を指す場合、javascriptjava script を入力するユーザーが存在します。JavaScript を提案することで、ユーザーによるアプリの操作方法を標準化できます。

指定すると、MULTIPLE_LINE に設定されていても、TextInput.type は常に SINGLE_LINE になります。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

フィールド
items[]

SuggestionItem

テキスト入力フィールドでオートコンプリートの候補に使用される候補のリスト。

SuggestionItem

ユーザーがテキスト入力フィールドに入力できる推奨値の 1 つ。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

フィールド

共用体フィールド content

content は次のいずれかになります。

text

string

テキスト入力フィールドへの候補入力の値。これはユーザーが自分自身で入力する内容と同じです。

TextInput

ユーザーがテキストを入力できるフィールド。提案と変更時のアクションをサポートします。Google Chat アプリの例については、テキスト入力をご覧ください。

チャットアプリは、フォーム入力イベント中に入力されたテキストの値を受信し、処理できます。フォーム入力の操作について詳しくは、フォームデータを受信するをご覧ください。

未定義のデータや抽象的なデータを収集する必要がある場合は、テキスト入力を使用します。定義済みデータまたは列挙データをユーザーから収集するには、SelectionInput ウィジェットを使用します。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

フィールド
name

string

フォーム入力イベントでテキスト入力を識別する名前。

フォーム入力の操作について詳しくは、フォームデータを受信するをご覧ください。

label

string

ユーザー インターフェースのテキスト入力フィールドの上に表示されるテキスト。

ユーザーがアプリに必要な情報を入力するのに役立つテキストを指定します。たとえば、誰かの名前を尋ねているが、その人の姓が特に必要な場合は、name ではなく surname と記述します。

hintText が指定されていない場合は必須です。それ以外の場合は省略可。

hintText

string

テキスト入力フィールドの下に表示されるテキスト。ユーザーに特定の値の入力を促します。このテキストは常に表示されます。

label が指定されていない場合は必須です。それ以外の場合は省略可。

value

string

ユーザーが入力した値。フォーム入力イベントの一部として返されます。

フォーム入力の操作について詳しくは、フォームデータを受信するをご覧ください。

type

Type

ユーザー インターフェースにおけるテキスト入力フィールドの表示。たとえば、フィールドが単一行か複数行かなどです。

onChangeAction

Action

テキスト入力フィールドで変更が発生した場合の処理。たとえば、ユーザーによるフィールドへの追加やテキストの削除などです。

実行できるアクションの例として、カスタム関数を実行する、Google Chat でダイアログを開くなどが挙げられます。

initialSuggestions

Suggestions

ユーザーが入力できる推奨値。これらの値は、ユーザーがテキスト入力フィールドの中をクリックすると表示されます。ユーザーが入力を始めると、入力内容に応じて推奨値が動的にフィルタされます。

たとえば、プログラミング言語のテキスト入力フィールドには、Java、JavaScript、Python、C++ の候補が表示されます。ユーザーが Jav の入力を開始すると、候補のリストに JavaJavaScript のみが表示されます。

推奨値は、ユーザーがアプリで理解できる値をユーザーが入力できるようにするのに役立ちます。JavaScript を指す場合、javascriptjava script を入力するユーザーが存在します。JavaScript を提案することで、ユーザーによるアプリの操作方法を標準化できます。

指定すると、MULTIPLE_LINE に設定されていても、TextInput.type は常に SINGLE_LINE になります。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

autoCompleteAction

Action

省略可。テキスト入力フィールドから操作を行ったユーザーに候補が表示された場合のアクションを指定します。

指定しない場合、提案は initialSuggestions によって設定され、クライアントによって処理されます。

指定すると、アプリは、カスタム関数の実行など、ここで指定されたアクションを実行します。

Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。

placeholderText

string

テキスト入力フィールドが空のときに表示されるテキスト。このテキストを使用して、ユーザーに値の入力を促します。例: Enter a number from 0 to 100

Google Chat アプリで利用できますが、Google Workspace アドオンでは利用できません。

タイプ

ユーザー インターフェースにおけるテキスト入力フィールドの表示。たとえば、単一行の入力フィールドか複数行の入力フィールドかなどです。initialSuggestions が指定されている場合、MULTIPLE_LINE に設定されていても、type は常に SINGLE_LINE です。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

列挙型
SINGLE_LINE テキスト入力フィールドの高さは 1 行に固定されています。
MULTIPLE_LINE テキスト入力フィールドの高さは複数行に固定されています。

TextParagraph

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

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

フィールド
text

string

ウィジェットに表示されるテキスト。

ウィジェット

各カードはウィジェットで構成されています。

ウィジェットは、テキスト、画像、ボタンなどのオブジェクト タイプのいずれかを表す複合オブジェクトです。

フィールド
horizontalAlignment

HorizontalAlignment

ウィジェットを列の左、右、中央に揃えるかどうかを指定します。

共用体フィールド data。ウィジェットに含めることができるアイテムは、次のいずれかのみです。複数のウィジェット フィールドを使用して、さらに多くのアイテムを表示できます。data は次のいずれかになります。
textParagraph

TextParagraph

段落テキストを表示します。シンプルな HTML 形式のテキストをサポートします。テキストの書式設定について詳しくは、Google Chat アプリでのテキストの書式設定Google Workspace アドオンでのテキストの書式設定をご覧ください。

たとえば、次の JSON は太字のテキストを作成します。

"textParagraph": {
  "text": "  <b>bold text</b>"
}
image

Image

画像を表示します。

たとえば、次の JSON は代替テキストを含む画像を作成します。

"image": {
  "imageUrl":
  "https://developers.google.com/chat/images/quickstart-app-avatar.png",
  "altText": "Chat app avatar"
}
decoratedText

DecoratedText

装飾されたテキスト アイテムを表示します。

たとえば、次の JSON は、メールアドレスを示す装飾されたテキスト ウィジェットを作成します。

"decoratedText": {
  "icon": {
    "knownIcon": "EMAIL"
  },
  "topLabel": "Email Address",
  "text": "sasha@example.com",
  "bottomLabel": "This is a new Email address!",
  "switchControl": {
    "name": "has_send_welcome_email_to_sasha",
    "selected": false,
    "controlType": "CHECKBOX"
  }
}
buttonList

ButtonList

ボタンのリスト。

たとえば、次の JSON は 2 つのボタンを作成します。1 つ目は青色のテキストボタン、2 つ目はリンクを開く画像ボタンです。

"buttonList": {
  "buttons": [
    {
      "text": "Edit",
      "color": {
        "red": 0,
        "green": 0,
        "blue": 1,
        "alpha": 1
      },
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}
textInput

TextInput

ユーザーが入力できるテキスト ボックスを表示します。

たとえば、次の JSON はメールアドレスのテキスト入力を作成します。

"textInput": {
  "name": "mailing_address",
  "label": "Mailing Address"
}

別の例として、次の JSON は、静的な候補を使用するプログラミング言語のテキスト入力を作成します。

"textInput": {
  "name": "preferred_programing_language",
  "label": "Preferred Language",
  "initialSuggestions": {
    "items": [
      {
        "text": "C++"
      },
      {
        "text": "Java"
      },
      {
        "text": "JavaScript"
      },
      {
        "text": "Python"
      }
    ]
  }
}
selectionInput

SelectionInput

ユーザーがアイテムを選択できる選択コントロールを表示します。選択コントロールには、チェックボックス、ラジオボタン、スイッチ、プルダウン メニューがあります。

たとえば、次の JSON は、ユーザーがサイズを選択できるプルダウン メニューを作成します。

"selectionInput": {
  "name": "size",
  "label": "Size"
  "type": "DROPDOWN",
  "items": [
    {
      "text": "S",
      "value": "small",
      "selected": false
    },
    {
      "text": "M",
      "value": "medium",
      "selected": true
    },
    {
      "text": "L",
      "value": "large",
      "selected": false
    },
    {
      "text": "XL",
      "value": "extra_large",
      "selected": false
    }
  ]
}
dateTimePicker

DateTimePicker

ユーザーが日時を入力できるウィジェットを表示します。

たとえば、次の JSON は、予約をスケジュールする日時選択ツールを作成します。

"dateTimePicker": {
  "name": "appointment_time",
  "label": "Book your appointment at:",
  "type": "DATE_AND_TIME",
  "valueMsEpoch": "796435200000"
}
divider

Divider

ウィジェット間に水平線の分割線を表示します。

たとえば、次の JSON は分割線を作成します。

"divider": {
}
grid

Grid

アイテムのコレクションをグリッドに表示します。

グリッドは任意の数の列とアイテムをサポートします。行数は、数値項目の上限を列数で割った値です。2 つの列に 10 個の項目があるグリッドには 5 行あります。11 個の項目と 2 列のグリッドには 6 行あります。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

たとえば、次の JSON は 1 つのアイテムを含む 2 列のグリッドを作成します。

"grid": {
  "title": "A fine collection of items",
  "columnCount": 2,
  "borderStyle": {
    "type": "STROKE",
    "cornerRadius": 4
  },
  "items": [
    {
      "image": {
        "imageUri": "https://www.example.com/image.png",
        "cropStyle": {
          "type": "SQUARE"
        },
        "borderStyle": {
          "type": "STROKE"
        }
      },
      "title": "An item",
      "textAlignment": "CENTER"
    }
  ],
  "onClick": {
    "openLink": {
      "url": "https://www.example.com"
    }
  }
}
columns

Columns

最大 2 列まで表示されます。

3 つ以上の列を含める、または行を使用する場合は、Grid ウィジェットを使用します。

たとえば、次の JSON は、それぞれテキスト段落を含む 2 つの列を作成します。

"columns": {
  "columnItems": [
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "First column text paragraph"
          }
        }
      ]
    },
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "Second column text paragraph"
          }
        }
      ]
    }
  ]
}

HorizontalAlignment

ウィジェットを列の左、右、中央に揃えるかどうかを指定します。

Google Chat アプリで利用できますが、Google Workspace アドオンでは利用できません。

列挙型
HORIZONTAL_ALIGNMENT_UNSPECIFIED 使用しないでください。(指定なし)
START デフォルト値。列の開始位置に合わせてウィジェットを調整します。左から右のレイアウトの場合は、左に揃えます。右から左へのレイアウトの場合は、右に揃えます。
CENTER ウィジェットを列の中央に揃えます。
END 列の最終位置に合わせてウィジェットを調整します。左から右のレイアウトの場合、ウィジェットを右に揃えます。右から左へのレイアウトでは、ウィジェットを左に揃えます。

ImageType

画像の切り抜きに使用する形状。

Google Chat アプリと Google Workspace アドオンでご利用いただけます。

列挙型
SQUARE デフォルト値。画像に正方形のマスクを適用します。たとえば、4x3 の画像は 3x3 になります。
CIRCLE 円形マスクを画像に適用します。たとえば、4x3 の画像は直径 3 の円になります。