Package google.apps.card.v1

string

要素を含む要素がクリックされるかアクティブ化されたときに呼び出されるカスタム関数。

使用例については、フォームデータを読み取るをご覧ください。

ActionParameter

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

LoadIndicator

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

bool

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

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

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

Interaction

省略可。ダイアログを開くときに必要です。

ユーザーとのやり取り（カード メッセージのボタンのクリックなど）に対する応答内容。

指定しない場合、アプリは通常どおり action を実行して応答します（リンクを開く、関数を実行するなど）。

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

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

string

このアクションが呼び出されたときにここにリストされているウィジェットに値がない場合、フォームの送信は中止されます。

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

bool

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

string

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

string

パラメータの値。

BorderType

枠線の種類。

Color

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

ストロークの色を設定するには、red フィールド、green フィールド、blue フィールドの値を指定します。この値は、RGB カラー値に基づく 0 ～ 1 の浮動小数点数で指定する必要があります。ここで、0（0/255）は無色、1（255/255）は色の最大強度を表します。

たとえば、次の例では、最大強度で色を赤に設定しています。

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
}

alpha フィールドではストロークの色を指定できません。指定すると、このフィールドは無視されます。

int32

枠線の角の半径です。

string

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

Icon

ボタン内に表示されるアイコン。icon と text の両方を設定した場合、アイコンはテキストの前に表示されます。

Color

省略可。ボタンの色。設定すると、ボタン type は FILLED に設定され、text フィールドと icon フィールドの色は、読みやすくなるようにコントラストの強い色に設定されます。たとえば、ボタンの色を青に設定している場合、ボタン内のテキストやアイコンはすべて白に設定されます。

ボタンの色を設定するには、red フィールド、green フィールド、blue フィールドの値を指定します。この値は、RGB カラー値に基づく 0 ～ 1 の浮動小数点数で指定する必要があります。ここで、0（0/255）は無色、1（255/255）は色の最大強度を表します。

たとえば、次の例では、最大強度で色を赤に設定しています。

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
}

alpha フィールドはボタンの色には使用できません。指定すると、このフィールドは無視されます。

OnClick

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

bool

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

string

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

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

Type

省略可。ボタンのタイプ。未設定の場合、ボタンのタイプはデフォルトで OUTLINED になります。color フィールドが設定されている場合、ボタンのタイプは強制的に FILLED に設定され、このフィールドに設定された値は無視されます。

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

Button

ボタンの配列。

CardHeader

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

Section

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

DividerStyle

セクション間の分割線のスタイル。

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"
      }
    }
  }
]

string

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

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

CardFixedFooter

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

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

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

DisplayStyle

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

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

CardHeader

コンテキスト コンテンツを表示する場合、ピークカードのヘッダーはプレースホルダとして機能するため、ユーザーはホームページ カードとコンテキスト カードの間を行き来できます。

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

string

操作メニュー項目として表示されるラベル。

OnClick

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

Button

固定フッターのメインボタン。ボタンは、テキストと色が設定されたテキストボタンであること。

Button

固定フッターのサブボタン。ボタンは、テキストと色が設定されたテキストボタンであること。secondaryButton が設定されている場合は、primaryButton も設定する必要があります。

string

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

string

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

ImageType

画像の切り抜きに使用される図形。

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

string

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

string

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

string

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

Widget

セクションのすべてのウィジェット。ウィジェットを 1 つ以上含める必要があります。

bool

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

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

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

int32

セクションを折りたたんだ状態でも表示されたままになる、折りたたみできないウィジェットの数です。

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

CollapseControl

省略可。セクションの展開ボタンと折りたたみボタンを定義します。このボタンは、セクションが折りたたみ可能な場合にのみ表示されます。このフィールドが設定されていない場合は、デフォルトのボタンが使用されます。Google Chat アプリで利用でき、Google Workspace アドオンでは利用できません。

Icon

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

string

チップ内に表示されるテキスト。

OnClick

省略可。ハイパーリンクを開く、カスタム関数を実行するなど、ユーザーがチップをクリックしたときに実行するアクション。

bool

チップがアクティブ状態にあり、ユーザーの操作に応答するかどうか。デフォルトは true です。非推奨です。代わりに disabled を使用してください。

bool

チップが非アクティブな状態にあり、ユーザーの操作を無視するかどうか。デフォルトは false です。

string

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

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

Layout

指定されたチップリストのレイアウト。

Chip

チップの配列。

HorizontalAlignment

展開ボタンと折りたたみボタンの水平方向の配置。

Button

省略可。セクションを展開するカスタマイズ可能なボタンを定義します。ExpandButton フィールドと expandButton フィールドの両方を設定する必要があります。1 つのフィールド セットのみが有効になりません。このフィールドが設定されていない場合は、デフォルトのボタンが使用されます。

Button

省略可。セクションを折りたたむためのカスタマイズ可能なボタンを定義します。ExpandButton フィールドと expandButton フィールドの両方を設定する必要があります。1 つのフィールド セットのみが有効になりません。このフィールドが設定されていない場合は、デフォルトのボタンが使用されます。

Column

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

HorizontalSizeStyle

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

HorizontalAlignment

ウィジェットの配置を、左、右、中央のいずれにするかを指定します。

VerticalAlignment

ウィジェットを列の上部、下部、中央のどちらに揃えるかを指定します。

Widgets

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

TextParagraph

TextParagraphウィジェットです。

Image

Imageウィジェットです。

DecoratedText

DecoratedTextウィジェットです。

ButtonList

ButtonListウィジェットです。

TextInput

TextInputウィジェットです。

SelectionInput

SelectionInputウィジェットです。

DateTimePicker

DateTimePickerウィジェットです。

ChipList

ChipList ウィジェット。Google Chat アプリで利用でき、Google Workspace アドオンでは利用できません。

string

フォーム入力イベントで DateTimePicker が識別される名前。

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

string

日付、時刻、または日時の入力をユーザーに促すテキスト。たとえば、ユーザーが予約をスケジュールしている場合は、Appointment date や Appointment date and time などのラベルを使用します。

DateTimePickerType

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

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）を使用します。

int32

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

Action

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

Validation

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

Icon

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

Icon

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

string

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

string

必須。プライマリ テキスト。

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

bool

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

text にのみ適用され、topLabel と bottomLabel には適用されません。

string

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

OnClick

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

Button

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

SwitchControl

ユーザーがクリックして状態を変更し、アクションをトリガーできる切り替えウィジェット。

Icon

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

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

string

フォーム入力イベントでスイッチ ウィジェットが識別される名前。

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

string

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

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

bool

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

Action

実行する関数など、切り替え状態が変更されたときに実行するアクション。

ControlType

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

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

Action

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

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

Suggestions

string

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

string

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

GridItem

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

BorderStyle

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

int32

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

OnClick

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

string

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

ImageComponent

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

string

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

string

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

GridItemLayout

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

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/workspace/chat。

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

ImageType

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

string

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

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

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

string

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

例:

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

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

MaterialIcon

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

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

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

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

string

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

例:

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

OnClick

ユーザーが画像をクリックすると、この操作がトリガーされます。

string

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

string

画像の URL。

string

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

ImageCropStyle

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

BorderStyle

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

ImageCropType

切り抜きの種類。

double

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

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

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

string

アドオンに戻るリンクの URL。

string

アドオンに返すリンクのタイトル。

Card

サードパーティ サービスからのリンクに関する情報を表示するカード。

string

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

string

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

string

Google マテリアル アイコンで定義されているアイコン名（例: check_box）。無効な名前は破棄されて空の文字列に置き換えられるため、アイコンのレンダリングに失敗します。

bool

アイコンを塗りつぶしとしてレンダリングするかどうか。デフォルト値は false です。

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

int32

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

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

int32

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

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

bool

カードスタックで、ルートカードを除くすべてのカードがポップオフします。

bool

カードのスタックで 1 枚のカードがポップされます。

string

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

Card

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

Card

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

EndNavigation

ダイアログ フローによるナビゲーション アクションの終了。詳細については、Google Chat アプリのホームページを作成するをご覧ください。

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

string

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

Action

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

OpenLink

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

Action

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

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

Card

指定されている場合、クリックすると新しいカードがカードスタックにプッシュされます。

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

OverflowMenu

指定すると、この onClick でオーバーフロー メニューが開きます。Google Chat アプリで利用でき、Google Workspace アドオンでは利用できません。

string

開く URL。

OpenAs

リンクの開き方

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

OnClose

クライアントがリンクを開いた後にリンクを忘れたか、ウィンドウが閉じるまでリンクを監視するか。

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

OverflowMenuItem

必須。メニュー オプションのリスト。

Icon

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

string

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

OnClick

必須。メニュー オプションが選択されたときに呼び出されるアクション。この OnClick に OverflowMenu を含めることはできません。指定された OverflowMenu は破棄され、メニュー項目は無効になります。

bool

メニュー オプションを無効にするかどうか。デフォルトは false です。

Action

HostAppActionMarkup

個々のホストアプリで処理されるアクション。

string

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

Navigation

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

OpenLink

直ちに新しいタブまたはポップアップでターゲット リンクを開きます。

Notification

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

LinkPreview

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

Link

Google Workspace アプリケーション内で作成されたサードパーティ リソースへのリンク。1 つの項目を含むオブジェクトの配列としてフォーマットされます。詳細については、@ メニューからサードパーティのリソースを作成するをご覧ください。

string

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

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

string

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

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

SelectionType

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

SelectionItem

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

Action

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

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

int32

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

int32

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

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

Validation

プルダウン メニューの場合、この選択入力フィールドの検証。

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

Action

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

PlatformDataSource

Google Workspace のデータソース。

CommonDataSource

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

HostAppDataSourceMarkup

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

このフィールドは Google API クライアント ライブラリをサポートしていますが、Cloud クライアント ライブラリでは使用できません。詳細については、クライアント ライブラリをインストールするをご覧ください。

string

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

string

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

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

bool

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

string

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

string

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

RenderActions

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

bool

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

string

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

SuggestionItem

テキスト入力フィールドで予測入力の推奨事項に使用される候補のリスト。

string

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

string

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

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

string

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

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

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

string

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

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

string

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

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

Type

ユーザー インターフェースにテキスト入力フィールドがどのように表示されるか。たとえば、フィールドが 1 行か複数行かを示します。

Action

テキスト入力フィールドの変化があった場合の処理方法。（フィールドへの追加やテキストの削除など）。

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

Suggestions

ユーザーが入力できる候補値。これらの値は、ユーザーがテキスト入力フィールドをクリックすると表示されます。ユーザーの入力に応じて、ユーザーの入力内容に合わせて候補の値が動的にフィルタリングされます。

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

候補値により、アプリが理解できる値をユーザーが入力しやすくなります。JavaScript を参照する場合、ユーザーが「javascript」と入力し、別のユーザーが「java script」と入力することがあります。JavaScript を提案することで、ユーザーによるアプリの操作方法を標準化できます。

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

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

Action

省略可。テキスト入力フィールドを操作するユーザーに候補が提示されたときに実行するアクションを指定します。

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

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

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

Validation

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

string

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

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

string

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

int32

ウィジェットに表示されるテキストの最大行数。テキストが指定された最大行数を超えると、余分なコンテンツは [さらに表示] ボタンの後ろに隠されます。テキストが指定された最大行数以下の場合、[さらに表示] ボタンは表示されません。

デフォルト値は 0 で、この場合、すべてのコンテキストが表示されます。負の値は無視されます。Google Chat アプリで利用でき、Google Workspace アドオンでは利用できません。

int32

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

InputType

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

HorizontalAlignment

ウィジェットの配置を、左、右、中央のいずれにするかを指定します。

TextParagraph

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

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

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

Image

画像を表示します。

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

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

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

ボタンのリスト。

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

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

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

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

たとえば、次の 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

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

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

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

Divider

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

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

"divider": {
}

Grid

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

グリッドは、任意の数の列とアイテムをサポートします。行数は、項目数の上限を列数で割ることによって決定されます。10 個のアイテムと 2 列のグリッドが 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

最大 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"
          }
        }
      ]
    }
  ]
}

ChipList

チップのリスト。

たとえば、次の JSON は 2 つのチップを作成します。1 つ目はテキストチップ、2 つ目はリンクを開くアイコンチップです。

"chipList": {
  "chips": [
    {
      "text": "Edit",
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}

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