このページは Cloud Translation API によって翻訳されました。

Package google.apps.card.v1

インデックス

Action（メッセージ）
Action.ActionParameter（メッセージ）
Action.Interaction（列挙型）
Action.LoadIndicator（列挙型）
BorderStyle（メッセージ）
BorderStyle.BorderType（列挙型）
Button（メッセージ）
Button.Type（列挙型）
ButtonList（メッセージ）
Card（メッセージ）
Card.CardAction（メッセージ）
Card.CardFixedFooter（メッセージ）
Card.CardHeader（メッセージ）
Card.DisplayStyle（列挙型）
Card.DividerStyle（列挙型）
Card.NestedWidget（メッセージ）
Card.Section（メッセージ）
Card.Visibility（列挙型）
Carousel（メッセージ）
Carousel.CarouselCard（メッセージ）
Chip（メッセージ）
ChipList（メッセージ）
ChipList.Layout（列挙型）
CollapseControl（メッセージ）
Columns（メッセージ）
Columns.Column（メッセージ）
Columns.Column.HorizontalSizeStyle（列挙型）
Columns.Column.VerticalAlignment（列挙型）
Columns.Column.Widgets（メッセージ）
Condition（メッセージ）
Condition.ExpressionDataCondition（メッセージ）
Condition.ExpressionDataCondition.ConditionType（列挙型）
DataSourceConfig（メッセージ）
DateTimePicker（メッセージ）
DateTimePicker.DateTimePickerType（列挙型）
DecoratedText（メッセージ）
DecoratedText.SwitchControl（メッセージ）
DecoratedText.SwitchControl.ControlType（列挙型）
Divider（メッセージ）
EventAction（メッセージ）
EventAction.CommonWidgetAction（メッセージ）
EventAction.CommonWidgetAction.UpdateVisibilityAction（メッセージ）
ExpressionData（メッセージ）
Grid（メッセージ）
Grid.GridItem（メッセージ）
Grid.GridItem.GridItemLayout（列挙型）
Icon（メッセージ）
Image（メッセージ）
ImageComponent（メッセージ）
ImageCropStyle（メッセージ）
ImageCropStyle.ImageCropType（列挙型）
MaterialIcon（メッセージ）
OnClick（メッセージ）
OpenLink（メッセージ）
OpenLink.OnClose（列挙型）
OpenLink.OpenAs（列挙型）
OverflowMenu（メッセージ）
OverflowMenu.OverflowMenuItem（メッセージ）
SelectionInput（メッセージ）
SelectionInput.PlatformDataSource（メッセージ）
SelectionInput.PlatformDataSource.CommonDataSource（列挙型）
SelectionInput.SelectionItem（メッセージ）
SelectionInput.SelectionType（列挙型）
Suggestions（メッセージ）
Suggestions.SuggestionItem（メッセージ）
TextInput（メッセージ）
TextInput.Type（列挙型）
TextParagraph（メッセージ）
TextParagraph.TextSyntax（列挙型）
Trigger（メッセージ）
Validation（メッセージ）
Validation.InputType（列挙型）
Widget（メッセージ）
Widget.HorizontalAlignment（列挙型）
Widget.ImageType（列挙型）
Widget.VerticalAlignment（列挙型）

アクション

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

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド
`function`	`string` コンテナ要素がクリックされたとき、またはアクティブになったときに呼び出すカスタム関数。使用例については、フォームデータの読み取りをご覧ください。
`parameters[]`	`ActionParameter` アクションパラメータのリスト。
`load_indicator`	`LoadIndicator` アクションへの呼び出し中にアクションが表示する読み込みインジケーターを指定します。
`persist_values`	`bool` アクション後にフォームの値が保持されるかどうかを示します。デフォルト値は `false` です。 `true` の場合、アクションがトリガーされた後もフォームの値は残ります。アクションの処理中にユーザーが変更できるようにするには、`LoadIndicator` を `NONE` に設定します。Chat 用アプリのカードメッセージの場合、アクションの `ResponseType` を `UPDATE_MESSAGE` に設定し、アクションを含むカードと同じ `card_id` を使用する必要があります。 `false` の場合、アクションがトリガーされるとフォームの値がクリアされます。アクションの処理中にユーザーが変更できないようにするには、`LoadIndicator` を `SPINNER` に設定します。
`interaction`	`Interaction` 省略可。ダイアログを開く場合は必須。ユーザーとのインタラクション（カードメッセージ内のボタンのクリックなど）に対する応答。指定しない場合、アプリは通常どおり `action`（リンクを開く、関数を実行するなど）を実行して応答します。 `interaction` を指定することで、アプリは特別なインタラクティブな方法で応答できます。たとえば、`interaction` を `OPEN_DIALOG` に設定すると、アプリはダイアログを開くことができます。指定すると、読み込みインジケーターは表示されません。アドオンで指定されている場合、カード全体が削除され、クライアントに何も表示されません。 Google Chat アプリでは利用できますが、Google Workspace アドオンでは利用できません。
`required_widgets[]`	`string` 省略可。このリストに、有効な送信に必要なウィジェットの名前を入力します。この Action が呼び出されたときに、ここにリストされているウィジェットに値がない場合、フォームの送信は中止されます。 Google Chat アプリと Google Workspace アドオンで利用できます。
`all_widgets_are_required`	`bool` 省略可。true の場合、すべてウィジェットがこのアクションで必須と見なされます。 Google Chat アプリと Google Workspace アドオンで利用できます。

ActionParameter

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

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

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド

フィールド
`key`	`string` アクションスクリプトのパラメータの名前。
`value`	`string` パラメータの値。

key

string

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

value

string

パラメータの値。

インタラクション

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

ユーザーとのインタラクション（カードメッセージ内のボタンのクリックなど）に対する応答。

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

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

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

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

列挙型

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

列挙型
`INTERACTION_UNSPECIFIED`	デフォルト値。`action` は通常どおり実行されます。
`OPEN_DIALOG`	ダイアログを開きます。これは、Chat 用アプリがユーザーとのやり取りに使用する、ウィンドウ表示のカードベースのインターフェースです。カードメッセージのボタンクリックに対するレスポンスとして、Chat 用アプリでのみサポートされます。アドオンで指定されている場合、カード全体が削除され、クライアントに何も表示されません。 Google Chat アプリでは利用できますが、Google Workspace アドオンでは利用できません。

OPEN_DIALOG

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

カードメッセージのボタンクリックに対するレスポンスとして、Chat 用アプリでのみサポートされます。アドオンで指定されている場合、カード全体が削除され、クライアントに何も表示されません。

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

LoadIndicator

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

Google Chat アプリと Google Workspace アドオンで利用できます。

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

BorderStyle

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

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド

フィールド
`type`	`BorderType` 枠線の種類。
`stroke_color`	`Color` タイプが `BORDER_TYPE_STROKE` の場合に使用する色。ストロークの色を設定するには、`red`、`green`、`blue` フィールドの値を指定します。値は RGB カラー値に基づく 0 ～ 1 の浮動小数点数でなければなりません。`0`（0/255）は色がないことを表し、`1`（255/255）は色の最大強度を表します。たとえば、次の例では、最大強度で色を赤に設定します。 `"color": { "red": 1, "green": 0, "blue": 0, }` `alpha` フィールドはストロークの色では使用できません。指定した場合、このフィールドは無視されます。
`corner_radius`	`int32` 枠線の角の半径。

type

BorderType

枠線の種類。

stroke_color

Color

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

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

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

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

alpha フィールドはストロークの色では使用できません。指定した場合、このフィールドは無視されます。

corner_radius

int32

枠線の角の半径。

BorderType

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

Google Chat アプリと Google Workspace アドオンで利用できます。

列挙型
`BORDER_TYPE_UNSPECIFIED`	使用しないでください。指定なし。
`NO_BORDER`	枠線なし。
`STROKE`	デフォルト値。アウトライン。

ボタン

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

画像をクリックスルーボタンにするには、Image（ImageComponent ではない）を指定し、onClick アクションを設定します。

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド
`text`	`string` ボタン内に表示されるテキスト。
`icon`	`Icon` ボタン内に表示されるアイコン。`icon` と `text` の両方を設定すると、アイコンがテキストの前に表示されます。
`color`	`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` フィールドを使用できません。指定した場合、このフィールドは無視されます。
`on_click`	`OnClick` 必須。ユーザーがボタンをクリックしたときに実行するアクション（ハイパーリンクを開く、カスタム関数を実行するなど）。
`disabled`	`bool` `true` の場合、ボタンは非アクティブな状態で表示され、ユーザー操作に応答しません。
`alt_text`	`string` ユーザー補助機能で使用される代替テキスト。ボタンの機能をユーザーに知らせる説明テキストを設定します。たとえば、ボタンがハイパーリンクを開く場合は、「新しいブラウザタブを開き、https://developers.google.com/workspace/chat" の Google Chat デベロッパードキュメントに移動します」と記述します。
`type`	`Type` 省略可。ボタンのタイプ。設定しない場合、ボタンタイプはデフォルトで `OUTLINED` になります。`color` フィールドが設定されている場合、ボタンのタイプは強制的に `FILLED` になり、このフィールドに設定された値は無視されます。

タイプ

省略可。ボタンのタイプ。color フィールドが設定されている場合、type は強制的に FILLED になります。

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

列挙型
`TYPE_UNSPECIFIED`	使用しないでください。指定なし。
`OUTLINED`	アウトラインボタンは中強調ボタンです。通常、Chat 用アプリやアドオンのメインアクションではないものの、重要なアクションが含まれます。
`FILLED`	塗りつぶしボタンには、単色のコンテナがあります。視覚的なインパクトが最も大きく、Chat 用アプリやアドオンの重要なプライマリアクションにおすすめです。
`FILLED_TONAL`	塗りつぶしトーンボタンは、塗りつぶしボタンとアウトラインボタンの中間的な選択肢です。優先度の低いボタンをアウトラインボタンよりも少し強調する必要があるコンテキストで役立ちます。
`BORDERLESS`	ボタンのデフォルトの状態に、目に見えないコンテナが含まれていません。これは、特に複数のオプションを表示する場合に、優先度の最も低いアクションによく使用されます。

ButtonList

ボタンが横に並んだリスト。Google Chat アプリの例については、ボタンを追加するをご覧ください。

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド

フィールド
`buttons[]`	`Button` ボタンの配列。

buttons[]

Button

ボタンの配列。

カード

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

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

カードビルダーでカードを設計してプレビューします。

カードビルダーを開く

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

Google Chat アプリについては、カードまたはダイアログのコンポーネントを設計するをご覧ください。
Google Workspace アドオンについては、カードベースのインターフェースをご覧ください。

注: カードごとに最大 100 個のウィジェットを追加できます。この上限を超えるウィジェットは無視されます。この上限は、Google Chat 用アプリのカードメッセージとダイアログ、および Google Workspace アドオンのカードの両方に適用されます。

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

連絡先カードの例

Google Chat でサンプルカードメッセージを作成するには、次の JSON を使用します。

{
  "cardsV2": [
    {
      "cardId": "unique-card-id",
      "card": {
        "header": {
           "title": "Sasha",
           "subtitle": "Software Engineer",
           "imageUrl":
           "https://developers.google.com/workspace/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 アプリの例については、カードのセクションを定義するをご覧ください。
`section_divider_style`	`DividerStyle` ヘッダー、セクション、フッターの間の区切り線のスタイル。
`card_actions[]`	`CardAction` カードのアクション。アクションはカードのツールバーメニューに追加されます。 Google Workspace アドオンでは利用できますが、Google Chat アプリでは利用できません。たとえば、次の JSON は `Settings` オプションと `Send Feedback` オプションを含むカードアクションメニューを作成します。 `"card_actions": [ { "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` カードの名前。カードナビゲーションでカードの識別子として使用されます。 Google Workspace アドオンでは利用できますが、Google Chat アプリでは利用できません。
`fixed_footer`	`CardFixedFooter` このカードの下部に表示される固定フッター。 `primaryButton` または `secondaryButton` を指定せずに `fixedFooter` を設定すると、エラーが発生します。Chat 用アプリでは、ダイアログで固定フッターを使用できますが、カードメッセージでは使用できません。 Google Chat アプリと Google Workspace アドオンで利用できます。
`display_style`	`DisplayStyle` Google Workspace アドオンで、`peekCardHeader` の表示プロパティを設定します。 Google Workspace アドオンでは利用できますが、Google Chat アプリでは利用できません。
`peek_card_header`	`CardHeader` コンテキストコンテンツを表示する場合、ピークカードのヘッダーはプレースホルダとして機能し、ユーザーはホームページのカードとコンテキストカードの間を前後に移動できます。 Google Workspace アドオンでは利用できますが、Google Chat アプリでは利用できません。
`expression_data[]`	`ExpressionData` カードの式データ。 Google Workspace Studio を拡張する Google Workspace アドオンで利用できます。Google Chat アプリでは使用できません。

CardAction

カードアクションは、カードに関連付けられたアクションです。たとえば、請求書カードには、請求書の削除、請求書のメール送信、ブラウザでの請求書のオープンなどのアクションが含まれる場合があります。

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

フィールド

フィールド
`action_label`	`string` アクションメニュー項目として表示されるラベル。
`on_click`	`OnClick` このアクションアイテムの `onClick` アクション。

action_label

string

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

on_click

OnClick

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

CardFixedFooter

カードの下部に表示される永続的な（固定）フッター。

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

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

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド

フィールド
`primary_button`	`Button` 固定フッターのメインボタン。ボタンは、テキストと色が設定されたテキストボタンである必要があります。
`secondary_button`	`Button` 固定フッターのセカンダリボタン。ボタンは、テキストと色が設定されたテキストボタンである必要があります。`secondaryButton` を設定する場合は、`primaryButton` も設定する必要があります。

primary_button

Button

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

secondary_button

Button

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

CardHeader

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

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド
`title`	`string` 必須。カードのヘッダーのタイトル。ヘッダーの高さは固定されています。タイトルとサブタイトルの両方が指定されている場合、それぞれ 1 行を占有します。タイトルのみが指定されている場合は、両方の行が使用されます。
`subtitle`	`string` カードのヘッダーのサブタイトル。指定すると、`title` の下の行に単独で表示されます。
`image_type`	`ImageType` 画像の切り抜きに使用する図形。 Google Chat アプリと Google Workspace アドオンで利用できます。
`image_url`	`string` カードのヘッダーにある画像の HTTPS URL。
`image_alt_text`	`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`	設定されている場合、区切り線はレンダリングされません。このスタイルでは、レイアウトから区切り線が完全に削除されます。結果は、区切り線をまったく追加しない場合と同じになります。

NestedWidget

CarouselCard などのコンテナレイアウトに表示できるウィジェットのリスト。 Google Chat アプリでは利用できますが、Google Workspace アドオンでは利用できません。

フィールド
共用体フィールド `data`。 `data` は次のいずれかになります。
`text_paragraph`	`TextParagraph` テキスト段落ウィジェット。
`button_list`	`ButtonList` ボタンリストウィジェット。
`image`	`Image` 画像ウィジェット。

セクション

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

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド
`header`	`string` セクションの上部に表示されるテキスト。シンプルな HTML 形式のテキストをサポートします。テキストの書式設定について詳しくは、Google Chat アプリでテキストの書式を設定すると Google Workspace アドオンでテキストの書式を設定するをご覧ください。
`widgets[]`	`Widget` セクション内のすべてのウィジェット。少なくとも 1 つのウィジェットを含める必要があります。
`collapsible`	`bool` このセクションが折りたたみ可能かどうかを示します。折りたたみ可能なセクションでは、一部またはすべてのウィジェットが非表示になりますが、[もっと見る] をクリックすると、非表示のウィジェットを表示できます。[表示を減らす] をクリックすると、ウィジェットを再び非表示にできます。非表示にするウィジェットを特定するには、`uncollapsibleWidgetsCount` を指定します。
`uncollapsible_widgets_count`	`int32` セクションが折りたたまれても表示されたままになる、折りたたみ不可のウィジェットの数。たとえば、セクションに 5 つのウィジェットが含まれていて、`uncollapsibleWidgetsCount` が `2` に設定されている場合、最初の 2 つのウィジェットは常に表示され、最後の 3 つのウィジェットはデフォルトで折りたたまれます。`uncollapsibleWidgetsCount` は、`collapsible` が `true` の場合にのみ考慮されます。
`id`	`string` セクションに割り当てられる一意の ID。変更するセクションを識別するために使用されます。ID の最大文字数は 64 文字で、`[a-zA-Z0-9-]+` の形式にする必要があります。 Google Workspace Studio を拡張する Google Workspace アドオンで利用できます。Google Chat アプリでは使用できません。
`collapse_control`	`CollapseControl` 省略可。セクションの展開ボタンと折りたたみボタンを定義します。このボタンは、セクションが折りたたみ可能な場合にのみ表示されます。このフィールドが設定されていない場合、デフォルトのボタンが使用されます。

公開設定

UI 要素を表示するか非表示にするかを指定します。

Google Workspace Studio を拡張する Google Workspace アドオンで利用できます。Google Chat アプリでは使用できません。

列挙型
`VISIBILITY_UNSPECIFIED`	可視性が指定されていません。使用しないでください。
`VISIBLE`	UI 要素が表示されます。
`HIDDEN`	UI 要素が非表示になっています。

カルーセル

カルーセル（スライダーとも呼ばれます）は、ウィジェットのリストをスライドショー形式で回転させて表示し、前後のウィジェットに移動するボタンを備えています。

たとえば、次の例は、3 つのテキスト段落ウィジェットを含むカルーセルの JSON 表現です。

{
  "carouselCards": [
    {
      "widgets": [
        {
          "textParagraph": {
            "text": "First text paragraph in carousel",
          }
        }
      ]
    },
    {
      "widgets": [
        {
          "textParagraph": {
            "text": "Second text paragraph in carousel",
          }
        }
      ]
    },
    {
      "widgets": [
        {
          "textParagraph": {
            "text": "Third text paragraph in carousel",
          }
        }
      ]
    }
  ]
}

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

フィールド

フィールド
`carousel_cards[]`	`CarouselCard` カルーセルに含まれるカードのリスト。

carousel_cards[]

CarouselCard

カルーセルに含まれるカードのリスト。

CarouselCard

カルーセルアイテムとして表示できるカード。 Google Chat アプリでは利用できますが、Google Workspace アドオンでは利用できません。

フィールド

フィールド
`widgets[]`	`NestedWidget` カルーセルカードに表示されるウィジェットのリスト。ウィジェットは指定された順序で表示されます。
`footer_widgets[]`	`NestedWidget` カルーセルカードの下部に表示されるウィジェットのリスト。ウィジェットは指定された順序で表示されます。

widgets[]

NestedWidget

カルーセルカードに表示されるウィジェットのリスト。ウィジェットは指定された順序で表示されます。

footer_widgets[]

NestedWidget

カルーセルカードの下部に表示されるウィジェットのリスト。ウィジェットは指定された順序で表示されます。

チップ

ユーザーがクリックできるテキスト、アイコン、またはテキストとアイコンのチップ。

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド
`icon`	`Icon` アイコン画像。`icon` と `text` の両方を設定すると、アイコンがテキストの前に表示されます。
`label`	`string` チップ内に表示されるテキスト。
`on_click`	`OnClick` 省略可。ユーザーがチップをクリックしたときに実行するアクション（ハイパーリンクを開く、カスタム関数を実行するなど）。
`enabled (deprecated)`	`bool` この項目は非推奨です。チップがアクティブな状態で、ユーザー操作に応答するかどうか。デフォルトは `true` です。非推奨です。代わりに `disabled` を使用してください。
`disabled`	`bool` チップが非アクティブ状態であり、ユーザー操作を無視するかどうか。デフォルトは `false` です。
`alt_text`	`string` ユーザー補助機能で使用される代替テキスト。チップの機能をユーザーに知らせる説明テキストを設定します。たとえば、チップがハイパーリンクを開く場合は、「新しいブラウザタブを開き、https://developers.google.com/workspace/chat" の Google Chat デベロッパードキュメントに移動します」と記述します。

ChipList

水平方向に配置されたチップのリスト。水平方向にスクロールするか、次の行に折り返すことができます。

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド

フィールド
`layout`	`Layout` 指定されたチップリストのレイアウト。
`chips[]`	`Chip` チップの配列。

layout

Layout

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

chips[]

Chip

チップの配列。

レイアウト

チップリストのレイアウト。

列挙型
`LAYOUT_UNSPECIFIED`	使用しないでください。指定なし。
`WRAPPED`	デフォルト値。水平方向のスペースが十分でない場合、チップリストは次の行に折り返されます。
`HORIZONTAL_SCROLLABLE`	チップが使用可能なスペースに収まらない場合は、水平方向にスクロールします。

CollapseControl

開閉コントロールを表します。

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド

フィールド
`horizontal_alignment`	`HorizontalAlignment` 展開ボタンと折りたたみボタンの水平方向の配置。
`expand_button`	`Button` 省略可。カスタマイズ可能なボタンを定義して、セクションを開きます。expand_button フィールドと collapse_button フィールドの両方を設定する必要があります。1 つのフィールドセットのみが有効になりません。このフィールドが設定されていない場合、デフォルトのボタンが使用されます。
`collapse_button`	`Button` 省略可。セクションを折りたたむためのカスタマイズ可能なボタンを定義します。expand_button フィールドと collapse_button フィールドの両方を設定する必要があります。1 つのフィールドセットのみが有効になりません。このフィールドが設定されていない場合、デフォルトのボタンが使用されます。

horizontal_alignment

HorizontalAlignment

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

expand_button

Button

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

collapse_button

Button

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

列

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

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

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

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

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

Google Chat アプリと Google Workspace アドオンで利用できます。列をサポートするアドオン UI は次のとおりです。

ユーザーがメールの下書きからアドオンを開いたときに表示されるダイアログ。
ユーザーが Google カレンダーの予定の [添付ファイルを追加] メニューからアドオンを開いたときに表示されるダイアログ。

フィールド

フィールド
`column_items[]`	`Column` 列の配列。カードまたはダイアログには最大 2 つの列を含めることができます。

column_items[]

Column

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

列

列。

Google Workspace アドオンと Chat 用アプリ

フィールド
`horizontal_size_style`	`HorizontalSizeStyle` 列がカードの幅をどのように埋めるかを指定します。
`horizontal_alignment`	`HorizontalAlignment` ウィジェットを列の左、右、中央のいずれに配置するかを指定します。
`vertical_alignment`	`VerticalAlignment` ウィジェットを列の上、下、中央のいずれに配置するかを指定します。
`widgets[]`	`Widgets` 列に含まれるウィジェットの配列。ウィジェットは指定された順序で表示されます。

HorizontalSizeStyle

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

Google Workspace アドオンと Chat 用アプリ

列挙型
`HORIZONTAL_SIZE_STYLE_UNSPECIFIED`	使用しないでください。指定なし。
`FILL_AVAILABLE_SPACE`	デフォルト値。列は、カードの幅の 70% まで、利用可能なスペースを埋めます。両方の列が `FILL_AVAILABLE_SPACE` に設定されている場合、各列はスペースの 50% を占めます。
`FILL_MINIMUM_SPACE`	列は、可能な限り少ないスペースを占有し、カードの幅の 30% を超えません。

VerticalAlignment

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

Google Workspace アドオンと Chat 用アプリ

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

ウィジェット

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

Google Workspace アドオンと Chat 用アプリ

フィールド
共用体フィールド `data`。 `data` は次のいずれかになります。
`text_paragraph`	`TextParagraph` `TextParagraph`ウィジェットです。
`image`	`Image` `Image`ウィジェットです。
`decorated_text`	`DecoratedText` `DecoratedText`ウィジェットです。
`button_list`	`ButtonList` `ButtonList`ウィジェットです。
`text_input`	`TextInput` `TextInput`ウィジェットです。
`selection_input`	`SelectionInput` `SelectionInput`ウィジェットです。
`date_time_picker`	`DateTimePicker` `DateTimePicker`ウィジェットです。
`chip_list`	`ChipList` `ChipList`ウィジェットです。

条件

アクションをトリガーするために使用できる条件を表します。

Google Workspace Studio を拡張する Google Workspace アドオンで利用できます。Google Chat アプリでは使用できません。

フィールド

action_rule_id

string

ActionRule の一意の識別子。

共用体フィールド condition。条件。condition は次のいずれかになります。

expression_data_condition

ExpressionDataCondition

式データによって決定される条件。

ExpressionDataCondition

CEL を使用して評価される条件を表します。

Google Workspace Studio を拡張する Google Workspace アドオンで利用できます。Google Chat アプリでは使用できません。

フィールド

フィールド
`condition_type`	`ConditionType` 条件のタイプ。

condition_type

ConditionType

条件のタイプ。

ConditionType

条件のタイプ。

列挙型
`CONDITION_TYPE_UNSPECIFIED`	条件タイプが指定されていません。
`EXPRESSION_EVALUATION_SUCCESS`	式の評価が成功しました。
`EXPRESSION_EVALUATION_FAILURE`	式の評価に失敗しました。

DataSourceConfig

ウィジェットのデータソースの構成に役立つ構成オブジェクト。

Google Workspace Studio を拡張する Google Workspace アドオンで利用できます。Google Chat アプリでは使用できません。

フィールド

フィールド
共用体フィールド `data_source`。データソース。`data_source` は次のいずれかになります。
`remote_data_source`	`Action` データはリモートデータプロバイダから取得されます。
`platform_data_source`	`PlatformDataSource` データは Google Workspace アプリケーションからのものです。

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

remote_data_source

Action

データはリモートデータプロバイダから取得されます。

platform_data_source

PlatformDataSource

データは Google Workspace アプリケーションからのものです。

DateTimePicker

ユーザーが日付、時刻、または日付と時刻の両方を入力できるようにします。フォーム送信の検証をサポートします。Action.all_widgets_are_required が true に設定されている場合、またはこのウィジェットが Action.required_widgets で指定されている場合、値が選択されていないと送信アクションはブロックされます。Google Chat 用アプリの例については、ユーザーが日時を選択できるようにするをご覧ください。

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

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド
`name`	`string` フォーム入力イベントで `DateTimePicker` を識別するための名前。フォーム入力の操作の詳細については、フォームデータを受け取るをご覧ください。
`label`	`string` ユーザーに日付、時刻、または日時を入力するよう促すテキスト。たとえば、ユーザーが予約をスケジュールしている場合は、`Appointment date` や `Appointment date and time` などのラベルを使用します。
`type`	`DateTimePickerType` ウィジェットが日付、時刻、または日付と時刻の入力をサポートしているかどうか。
`value_ms_epoch`	`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`）を使用します。
`timezone_offset_date`	`int32` UTC からのタイムゾーンオフセット（分単位）を表す数値。設定されている場合、`value_ms_epoch` は指定されたタイムゾーンで表示されます。設定されていない場合、値はユーザーのタイムゾーン設定にデフォルト設定されます。
`on_change_action`	`Action` ユーザーが `DateTimePicker` インターフェースで [保存] または [クリア] をクリックするとトリガーされます。
共用体フィールド `data_source`。日付と時刻を表すために指定されたデータソース。`data_source` は次のいずれかになります。
`host_app_data_source`	`HostAppDataSourceMarkup` Gmail のメール、Google カレンダーの予定、Google Chat のメッセージなど、Google Workspace ホストアプリケーションに固有のデータソース。 Google Workspace Studio を拡張する Google Workspace アドオンで利用できます。Google Chat アプリでは使用できません。

DateTimePickerType

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

Google Chat アプリと Google Workspace アドオンで利用できます。

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

DecoratedText

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

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド
`icon (deprecated)`	`Icon` この項目は非推奨です。非推奨となり、`startIcon` に置き換えられました。
`start_icon`	`Icon` テキストの前に表示されるアイコン。
`start_icon_vertical_alignment`	`VerticalAlignment` 省略可。開始アイコンの垂直方向の配置。設定しない場合、アイコンは垂直方向に中央揃えになります。 Google Chat アプリでは利用できますが、Google Workspace アドオンでは利用できません。
`top_label`	`string` `text` の上に表示されるテキスト。常に切り捨てます。
`top_label_text`	`TextParagraph` `TextParagraph` は `top_label` と同等です。常に切り捨てられます。`top_label` よりも複雑な形式設定が可能です。 Google Chat アプリでは利用できますが、Google Workspace アドオンでは利用できません。
`text`	`string` 必須。メインのテキスト。簡単な書式設定をサポートしています。テキストの書式設定について詳しくは、Google Chat アプリでテキストの書式を設定すると Google Workspace アドオンでテキストの書式を設定するをご覧ください。
`content_text`	`TextParagraph` `TextParagraph` は `text` と同等です。`text` よりも複雑な形式設定が可能です。 Google Chat アプリでは利用できますが、Google Workspace アドオンでは利用できません。
`wrap_text`	`bool` テキストの折り返し設定。`true` の場合、テキストは折り返されて複数行に表示されます。それ以外の場合、テキストは切り捨てられます。 `text` にのみ適用され、`topLabel` と `bottomLabel` には適用されません。
`bottom_label`	`string` `text` の下に表示されるテキスト。常に折り返します。
`bottom_label_text`	`TextParagraph` `TextParagraph` は `bottom_label` と同等です。常に折り返します。`bottom_label` よりも複雑な形式設定が可能です。 Google Chat アプリでは利用できますが、Google Workspace アドオンでは利用できません。
`on_click`	`OnClick` このアクションは、ユーザーが `topLabel` または `bottomLabel` をクリックしたときにトリガーされます。
共用体フィールド `control`。`decoratedText` ウィジェットのテキストの右側に表示されるボタン、切り替え、チェックボックス、画像。`control` は次のいずれかになります。
`button`	`Button` ユーザーがクリックしてアクションをトリガーできるボタン。
`switch_control`	`SwitchControl` ユーザーがクリックして状態を変更し、アクションをトリガーできるスイッチウィジェット。
`end_icon`	`Icon` テキストの後に表示されるアイコン。組み込みアイコンとカスタムアイコンをサポートします。

SwitchControl

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

Google Chat アプリと Google Workspace アドオンで利用できます。

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

フィールド
`name`	`string` フォーム入力イベントでスイッチウィジェットを識別する名前。フォーム入力の操作の詳細については、フォームデータを受け取るをご覧ください。
`value`	`string` ユーザーが入力した値。フォーム入力イベントの一部として返されます。フォーム入力の操作の詳細については、フォームデータを受け取るをご覧ください。
`selected`	`bool` `true` の場合、スイッチが選択されます。
`on_change_action`	`Action` スイッチの状態が変更されたときに実行するアクション（実行する関数など）。
`control_type`	`ControlType` ユーザーインターフェースでの切り替えの表示方法。 Google Chat アプリと Google Workspace アドオンで利用できます。

ControlType

ユーザーインターフェースでの切り替えの表示方法。

Google Chat アプリと Google Workspace アドオンで利用できます。

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

分割線

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

ウィジェット間の区切りを水平線として表示します。Google Chat アプリの例については、ウィジェット間に水平区切り線を追加するをご覧ください。

Google Chat アプリと Google Workspace アドオンで利用できます。

たとえば、次の JSON は区切り線を作成します。

"divider": {}

EventAction

UI 要素に対して実行できるアクションを表します。

Google Workspace Studio を拡張する Google Workspace アドオンで利用できます。Google Chat アプリでは使用できません。

フィールド
`action_rule_id`	`string` ActionRule の一意の識別子。
`post_event_triggers[]`	`Trigger` EventAction の実行後にトリガーされるトリガーのリスト。
共用体フィールド `action`。実行するアクション。`action` は次のいずれかになります。
`common_widget_action`	`CommonWidgetAction` 一般的なウィジェットアクション。

CommonWidgetAction

ウィジェットに固有ではないアクションを表します。

Google Workspace Studio を拡張する Google Workspace アドオンで利用できます。Google Chat アプリでは使用できません。

フィールド

フィールド
共用体フィールド `action`。実行するアクション。`action` は次のいずれかになります。
`update_visibility_action`	`UpdateVisibilityAction` ウィジェットの表示設定を更新するアクション。

共用体フィールド action。実行するアクション。action は次のいずれかになります。

update_visibility_action

UpdateVisibilityAction

ウィジェットの表示設定を更新するアクション。

UpdateVisibilityAction

ウィジェットの表示 / 非表示を更新するアクションを表します。

Google Workspace Studio を拡張する Google Workspace アドオンで利用できます。Google Chat アプリでは使用できません。

フィールド

フィールド
`visibility`	`Visibility` 新しい公開設定。

visibility

Visibility

新しい公開設定。

ExpressionData

式を評価するために使用されるデータを表します。

Google Workspace Studio を拡張する Google Workspace アドオンで利用できます。Google Chat アプリでは使用できません。

フィールド
`id`	`string` ExpressionData の一意の識別子。
`expression`	`string` コンパイルされていない式。
`conditions[]`	`Condition` 式の評価結果によって決定される条件のリスト。
`event_actions[]`	`EventAction` ExpressionData を使用できるアクションのリスト。

グリッド

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

グリッドは任意の数の列とアイテムをサポートします。行数は、アイテム数を列数で割った値で決まります。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"
    }
  }
}

フィールド
`title`	`string` グリッドのヘッダーに表示されるテキスト。
`items[]`	`GridItem` グリッドに表示するアイテム。
`border_style`	`BorderStyle` 各グリッドアイテムに適用する枠線のスタイル。
`column_count`	`int32` グリッドに表示する列の数。このフィールドが指定されていない場合はデフォルト値が使用されます。このデフォルト値は、グリッドが表示される場所（ダイアログとコンパニオン）によって異なります。
`on_click`	`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`	タイトルとサブタイトルは、グリッドアイテムの画像の上に表示されます。

アイコン

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

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

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド
`alt_text`	`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` は無視されます。
`image_type`	`ImageType` 画像に適用された切り抜きスタイル。場合によっては、`CIRCLE` の切り抜きを適用すると、画像が組み込みアイコンよりも大きく描画されます。
共用体フィールド `icons`。カードのウィジェットに表示されるアイコン。`icons` は次のいずれかになります。
`known_icon`	`string` Google Workspace が提供する組み込みアイコンのいずれかを表示します。たとえば、飛行機のアイコンを表示するには、`AIRPLANE` を指定します。バスの場合は、`BUS` を指定します。サポートされているアイコンの完全なリストについては、組み込みアイコンをご覧ください。
`icon_url`	`string` HTTPS URL でホストされているカスタムアイコンを表示します。次に例を示します。 `"iconUrl": "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png"` サポートされているファイル形式は、`.png` や `.jpg` などです。
`material_icon`	`MaterialIcon` Google マテリアルアイコンのいずれかを表示します。たとえば、チェックボックスアイコンを表示するには、 `"material_icon": { "name": "check_box" }` Google Chat アプリでは利用できますが、Google Workspace アドオンでは利用できません。

画像

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

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド

フィールド
`image_url`	`string` 画像をホストする HTTPS URL。次に例を示します。 `https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png`
`on_click`	`OnClick` ユーザーが画像をクリックすると、このアクションがトリガーされます。
`alt_text`	`string` ユーザー補助機能で使用されるこの画像の代替テキスト。

image_url

string

画像をホストする HTTPS URL。

次に例を示します。

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

on_click

OnClick

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

alt_text

string

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

ImageComponent

画像を表します。

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド
`image_uri`	`string` 画像の URL。
`alt_text`	`string` 画像のユーザー補助ラベル。
`crop_style`	`ImageCropStyle` 画像に適用する切り抜きスタイル。
`border_style`	`BorderStyle` 画像に適用するボーダーのスタイル。

ImageCropStyle

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

Google Chat アプリと Google Workspace アドオンで利用できます。

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

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

フィールド

フィールド
`type`	`ImageCropType` 作物の種類。
`aspect_ratio`	`double` クロップタイプが `RECTANGLE_CUSTOM` の場合に使用するアスペクト比。たとえば、16:9 のアスペクト比を適用する方法は次のとおりです。 `cropStyle { "type": "RECTANGLE_CUSTOM", "aspectRatio": 16/9 }`

type

ImageCropType

作物の種類。

aspect_ratio

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 の長方形の切り抜きを適用します。

MaterialIcon

2, 500 以上のオプションを含む Google マテリアルアイコン。

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

{
  "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 にアクセスし、[カスタマイズ] で設定を調整します。

OnClick

ユーザーがカード上のインタラクティブな要素（ボタンなど）をクリックしたときのレスポンス方法を表します。

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド
共用体フィールド `data`。 `data` は次のいずれかになります。
`action`	`Action` 指定すると、この `onClick` によってアクションがトリガーされます。
`open_link`	`OpenLink` 指定されている場合、この `onClick` はリンクを開くアクションをトリガーします。
`open_dynamic_link_action`	`Action` アドオンは、リンクを開く必要がある場合にこのアクションをトリガーします。これは、リンクを取得するためにサーバーと通信する必要があるという点で、上記の `open_link` とは異なります。そのため、ウェブクライアントは、リンクを開くアクションのレスポンスが返ってくる前に、準備作業を行う必要があります。 Google Workspace アドオンでは利用できますが、Google Chat アプリでは利用できません。
`card`	`Card` 指定されている場合、クリック後に新しいカードがカードスタックにプッシュされます。 Google Workspace アドオンでは利用できますが、Google Chat アプリでは利用できません。
`overflow_menu`	`OverflowMenu` 指定されている場合、この `onClick` はオーバーフローメニューを開きます。

OpenLink

ハイパーリンクを開く onClick イベントを表します。

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド

url

string

開く URL。HTTP URL が HTTPS に変換されます。

open_as

OpenAs

リンクを開く方法。

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

on_close

OnClose

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

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`	リンクがポップアップなどのオーバーレイとして開きます。

OverflowMenu

ユーザーが呼び出すことができる 1 つ以上のアクションを含むポップアップメニューを表示するウィジェット。たとえば、カードにメイン以外の操作を表示する場合などです。このウィジェットは、アクションが使用可能なスペースに収まらない場合に使用できます。使用するには、このウィジェットをサポートするウィジェットの OnClick アクションで指定します。たとえば、Button で。

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド

items[]

OverflowMenuItem

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

OverflowMenuItem

ユーザーがオーバーフローメニューで呼び出すことができるオプション。

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド
`start_icon`	`Icon` テキストの前に表示されるアイコン。
`text`	`string` 必須。ユーザーにアイテムを識別または説明するテキスト。
`on_click`	`OnClick` 必須。メニューオプションが選択されたときに呼び出されるアクション。この `OnClick` に `OverflowMenu` を含めることはできません。指定された `OverflowMenu` は削除され、メニューアイテムは無効になります。
`disabled`	`bool` メニューオプションが無効かどうか。デフォルトは false です。

SelectionInput

ユーザーが選択できる 1 つ以上の UI アイテムを作成するウィジェット。dropdown メニューと multiselect メニューのフォーム送信検証のみをサポートします。Action.all_widgets_are_required が true に設定されている場合、またはこのウィジェットが Action.required_widgets で指定されている場合、値が選択されていないと送信アクションはブロックされます。たとえば、プルダウンメニューやチェックボックスなどです。このウィジェットを使用すると、予測または列挙可能なデータを収集できます。Google Chat アプリの例については、選択可能な UI 要素を追加するをご覧ください。

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

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

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド
`name`	`string` 必須。フォーム入力イベントで選択入力を識別する名前。フォーム入力の操作の詳細については、フォームデータを受け取るをご覧ください。
`label`	`string` ユーザーインターフェースの選択入力フィールドの上に表示されるテキスト。アプリに必要な情報をユーザーが入力するのに役立つテキストを指定します。たとえば、ユーザーがプルダウンメニューから作業チケットの緊急度を選択している場合、ラベルは「緊急度」または「緊急度を選択」になります。
`type`	`SelectionType` `SelectionInput` ウィジェットでユーザーに表示されるアイテムのタイプ。選択タイプは、さまざまなタイプのインタラクションをサポートします。たとえば、ユーザーは複数のチェックボックスを選択できますが、プルダウンメニューから選択できる値は 1 つだけです。
`items[]`	`SelectionItem` 選択可能なアイテムの配列。たとえば、ラジオボタンやチェックボックスの配列などです。最大 100 個のアイテムをサポートします。
`on_change_action`	`Action` 指定されている場合、選択が変更されるとフォームが送信されます。指定しない場合は、フォームを送信する別のボタンを指定する必要があります。フォーム入力の操作の詳細については、フォームデータを受け取るをご覧ください。
`multi_select_min_query_length`	`int32` 複数選択メニューの場合、メニューが候補の選択項目を返すまでにユーザーが入力するテキスト文字数。設定されていない場合、マルチ選択メニューでは次のデフォルト値が使用されます。メニューで `SelectionInput` アイテムの静的配列を使用している場合、デフォルトは 0 文字で、配列からアイテムがすぐに読み込まれます。メニューで動的データソース（`multi_select_data_source`）を使用している場合、デフォルトでは、データソースにクエリを実行して候補アイテムを返す前に 3 文字が入力されます。
`data_source_configs[]`	`DataSourceConfig` 省略可。選択コントロールのデータソース構成。このフィールドでは、データソースをよりきめ細かく制御できます。指定されている場合、`multi_select_max_selected_items` フィールド、`multi_select_min_query_length` フィールド、`external_data_source` フィールド、`platform_data_source` フィールドは無視されます。 Google Workspace Studio を拡張する Google Workspace アドオンで利用できます。Google Chat アプリでは使用できません。
`multi_select_max_selected_items`	`int32` 複数選択メニューの場合、ユーザーが選択できるアイテムの最大数。最小値は 1 個です。指定しない場合、デフォルトは 3 個のアイテムです。
`hint_text`	`string` 省略可。選択入力フィールドの下に表示されるテキスト。ユーザーが特定の値を入力するよう促すことで、ユーザーをサポートすることを目的としています。このテキストは常に表示されます。 Google Workspace Studio を拡張する Google Workspace アドオンで利用できます。Google Chat アプリでは使用できません。
共用体フィールド `multi_select_data_source`。複数選択メニューの場合、選択項目を動的に入力するデータソース。 Google Chat アプリでは使用できますが、Google Workspace アドオンでは使用できません。`multi_select_data_source` は次のいずれかになります。
`external_data_source`	`Action` リレーショナルデータベースなどの外部データソース。
`platform_data_source`	`PlatformDataSource` Google Workspace のデータソース。

PlatformDataSource

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

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

フィールド

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

common_data_source

CommonDataSource

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

host_app_data_source

HostAppDataSourceMarkup

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

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

CommonDataSource

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

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

列挙型
`UNKNOWN`	デフォルト値。使用しないでください。
`USER`	Google Workspace ユーザー。ユーザーは、自分の Google Workspace 組織のユーザーのみを表示して選択できます。

SelectionItem

チェックボックスやスイッチなどの選択入力でユーザーが選択できるアイテム。最大 100 個のアイテムをサポートします。

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド
`text`	`string` ユーザーにアイテムを識別または説明するテキスト。
`value`	`string` このアイテムに関連付けられた値。クライアントはこれをフォーム入力値として使用する必要があります。フォーム入力の操作の詳細については、フォームデータを受け取るをご覧ください。
`selected`	`bool` アイテムがデフォルトで選択されているかどうか。選択入力で 1 つの値のみが許可される場合（ラジオボタンやプルダウンメニューなど）、このフィールドは 1 つのアイテムに対してのみ設定します。
`bottom_text`	`string` 複数選択メニューの場合、項目の `text` フィールドの下に表示されるテキストの説明またはラベル。
共用体フィールド `start_icon`。複数選択メニューの場合、アイテムの `text` フィールドの横に表示されるアイコンの URL。PNG ファイルと JPEG ファイルをサポートしています。`HTTPS` URL である必要があります。たとえば、`https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png` のようにします。`start_icon` は次のいずれかになります。
`start_icon_uri`	`string`

SelectionType

ユーザーが選択できるアイテムの形式。オプションごとに、サポートされるインタラクションの種類が異なります。たとえば、ユーザーは複数のチェックボックスを選択できますが、プルダウンメニューから選択できるのは 1 つの項目のみです。

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

Google Chat アプリと Google Workspace アドオンで利用できます。

列挙型
`CHECK_BOX`	チェックボックスのセット。ユーザーは 1 つ以上のチェックボックスを選択できます。
`RADIO_BUTTON`	ラジオボタンのセット。ユーザーはラジオボタンを 1 つ選択できます。
`SWITCH`	スイッチのセット。ユーザーは 1 つ以上のスイッチをオンにできます。
`DROPDOWN`	プルダウンメニュー。ユーザーはメニューから 1 つの項目を選択できます。
`MULTI_SELECT`	テキストボックスを含むメニュー。ユーザーは 1 つ以上のアイテムを入力して選択できます。Google Workspace アドオンの場合、`SelectionItem` オブジェクトの静的配列を使用してアイテムを入力する必要があります。 Google Chat 用アプリでは、動的データソースを使用して項目を入力したり、ユーザーがメニューに入力する際に項目を自動提案したりすることもできます。たとえば、ユーザーが Google Chat スペースの名前の入力を開始すると、ウィジェットがスペースを自動的に提案します。マルチセレクトメニューの項目を動的に入力するには、次のいずれかのタイプのデータソースを使用します。 Google Workspace データ: Google Workspace ユーザーや Google Chat スペースなど、Google Workspace のデータを使用してアイテムが入力されます。外部データ: アイテムは、Google Workspace の外部にある外部データソースから入力されます。 Chat 用アプリに複数選択メニューを実装する方法の例については、複数選択メニューを追加するをご覧ください。 Google Chat アプリと Google Workspace アドオンで利用できます。

候補

ユーザーが入力できる候補値。これらの値は、ユーザーがテキスト入力フィールド内をクリックしたときに表示されます。ユーザーが入力すると、候補値が動的にフィルタされ、ユーザーが入力した内容に一致する値が表示されます。

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

候補値は、アプリが理解できる値をユーザーが入力できるようにするためのものです。JavaScript を参照する場合、javascript と入力するユーザーもいれば、java script と入力するユーザーもいます。JavaScript を提案することで、ユーザーがアプリを操作する方法を標準化できます。

指定した場合、TextInput.type が MULTIPLE_LINE に設定されていても、常に SINGLE_LINE になります。

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド

items[]

SuggestionItem

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

SuggestionItem

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

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド

共用体フィールド content。

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

text

string

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

TextInput

ユーザーがテキストを入力できるフィールド。提案と変更時のアクションをサポートします。フォーム送信の検証をサポートします。Action.all_widgets_are_required が true に設定されているか、このウィジェットが Action.required_widgets で指定されている場合、値を入力しないと送信アクションはブロックされます。Google Chat 用アプリの例については、ユーザーがテキストを入力できるフィールドを追加するをご覧ください。

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

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

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド
`name`	`string` フォーム入力イベントでテキスト入力が識別される名前。フォーム入力の操作の詳細については、フォームデータを受け取るをご覧ください。
`label`	`string` ユーザーインターフェースのテキスト入力フィールドの上に表示されるテキスト。アプリに必要な情報をユーザーが入力するのに役立つテキストを指定します。たとえば、相手の名前を尋ねる際に、特に姓が必要な場合は、`name` ではなく `surname` と記述します。 `hintText` が指定されていない場合は必須。それ以外の場合は省略可。
`hint_text`	`string` テキスト入力フィールドの下に表示されるテキスト。ユーザーが特定の値を入力するよう促すことで、ユーザーをサポートすることを目的としています。このテキストは常に表示されます。 `label` が指定されていない場合は必須。それ以外の場合は省略可。
`value`	`string` ユーザーが入力した値。フォーム入力イベントの一部として返されます。フォーム入力の操作の詳細については、フォームデータを受け取るをご覧ください。
`type`	`Type` ユーザーインターフェースでのテキスト入力フィールドの表示方法。たとえば、フィールドが単一行か複数行かなどです。
`on_change_action`	`Action` テキスト入力フィールドで変更が発生した場合の処理。たとえば、ユーザーがフィールドにテキストを追加したり、テキストを削除したりする場合です。実行するアクションの例としては、カスタム関数を実行する、Google Chat でダイアログを開くなどがあります。
`initial_suggestions`	`Suggestions` ユーザーが入力できる候補値。これらの値は、ユーザーがテキスト入力フィールド内をクリックしたときに表示されます。ユーザーが入力すると、候補値が動的にフィルタされ、ユーザーが入力した内容に一致する値が表示されます。たとえば、プログラミング言語のテキスト入力フィールドでは、Java、JavaScript、Python、C++ が候補として表示されることがあります。ユーザーが `Jav` と入力し始めると、候補のリストがフィルタされ、`Java` と `JavaScript` のみが表示されます。候補値は、アプリが理解できる値をユーザーが入力できるようにするためのものです。JavaScript を参照する場合、`javascript` と入力するユーザーもいれば、`java script` と入力するユーザーもいます。`JavaScript` を提案することで、ユーザーがアプリを操作する方法を標準化できます。指定した場合、`TextInput.type` が `MULTIPLE_LINE` に設定されていても、常に `SINGLE_LINE` になります。 Google Chat アプリと Google Workspace アドオンで利用できます。
`auto_complete_action`	`Action` 省略可。テキスト入力フィールドで、操作しているユーザーに候補を表示する際のアクションを指定します。指定しない場合、候補は `initialSuggestions` によって設定され、クライアントによって処理されます。指定されている場合、アプリはここで指定されたアクション（カスタム関数の実行など）を実行します。 Google Workspace アドオンでは利用できますが、Google Chat アプリでは利用できません。
`validation`	`Validation` このテキストフィールドに必要な入力形式の検証を指定します。 Google Chat アプリと Google Workspace アドオンで利用できます。
`placeholder_text`	`string` フィールドが空の場合にテキスト入力フィールドに表示されるテキスト。このテキストを使用して、ユーザーに値を入力するよう促します。例: `Enter a number from 0 to 100` Google Chat アプリでは利用できますが、Google Workspace アドオンでは利用できません。
共用体フィールド `data_source`。 `data_source` は次のいずれかになります。
`host_app_data_source`	`HostAppDataSourceMarkup` Gmail のメール、Google カレンダーの予定、Google Chat のメッセージなど、Google Workspace ホストアプリケーションに固有のデータソース。 Google Workspace Studio を拡張する Google Workspace アドオンで利用できます。Google Chat アプリでは使用できません。

タイプ

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

Google Chat アプリと Google Workspace アドオンで利用できます。

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

TextParagraph

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

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド

text

string

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

max_lines

int32

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

デフォルト値は 0 で、この場合、すべてのコンテキストが表示されます。負の値は無視されます。

text_syntax

TextSyntax

テキストの構文。設定されていない場合、テキストは HTML としてレンダリングされます。

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

TextSyntax

テキストの書式設定に使用する構文。

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

列挙型
`TEXT_SYNTAX_UNSPECIFIED`	指定しない場合、テキストは HTML としてレンダリングされます。
`HTML`	テキストは HTML としてレンダリングされます。これがデフォルト値です。
`MARKDOWN`	テキストはマークダウンとしてレンダリングされます。

トリガー

トリガーを表します。

Google Workspace Studio を拡張する Google Workspace アドオンで利用できます。Google Chat アプリでは使用できません。

フィールド

action_rule_id

string

ActionRule の一意の識別子。

検証

アタッチされているウィジェットを検証するために必要なデータを表します。

Google Chat アプリと Google Workspace アドオンで利用できます。

フィールド

character_limit

int32

テキスト入力ウィジェットの文字数制限を指定します。これはテキスト入力にのみ使用され、他のウィジェットでは無視されます。

Google Chat アプリと Google Workspace アドオンで利用できます。

input_type

InputType

入力ウィジェットのタイプを指定します。

Google Chat アプリと Google Workspace アドオンで利用できます。

InputType

入力ウィジェットのタイプ。

列挙型
`INPUT_TYPE_UNSPECIFIED`	タイプの指定なし。使用しないでください。
`TEXT`	すべての文字を受け入れる通常のテキスト。
`INTEGER`	整数値。
`FLOAT`	浮動小数点数値。
`EMAIL`	メールアドレス。
`EMOJI_PICKER`	システム提供の絵文字選択ツールから選択された絵文字。

フィールド
`horizontal_alignment`	`HorizontalAlignment` ウィジェットを列の左、右、中央のいずれに配置するかを指定します。
`id`	`string` ウィジェットに割り当てられた一意の ID。変更するウィジェットの識別に使用されます。ID の最大文字数は 64 文字で、`[a-zA-Z0-9-]+` の形式にする必要があります。 Google Workspace Studio を拡張する Google Workspace アドオンで利用できます。Google Chat アプリでは使用できません。
`visibility`	`Visibility` ウィジェットが表示されるか非表示になるかを指定します。デフォルト値は `VISIBLE` です。 Google Workspace Studio を拡張する Google Workspace アドオンで利用できます。Google Chat アプリでは使用できません。
`event_actions[]`	`EventAction` ウィジェットで実行できるイベントアクションを指定します。 Google Workspace Studio を拡張する Google Workspace アドオンで利用できます。Google Chat アプリでは使用できません。
共用体フィールド `data`。ウィジェットには、次のいずれか 1 つのみを含めることができます。複数のウィジェットフィールドを使用して、より多くのアイテムを表示できます。`data` は次のいずれかになります。
`text_paragraph`	`TextParagraph` テキストの段落を表示します。シンプルな HTML 形式のテキストをサポートします。テキストの書式設定について詳しくは、Google Chat アプリでテキストの書式を設定すると Google Workspace アドオンでテキストの書式を設定するをご覧ください。たとえば、次の JSON は太字のテキストを作成します。 `"textParagraph": { "text": " <b>bold text</b>" }`
`image`	`Image` 画像を表示します。たとえば、次の JSON は代替テキストを含む画像を作成します。 `"image": { "imageUrl": "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png", "altText": "Chat app avatar" }`
`decorated_text`	`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" } }`
`button_list`	`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" } } } ] }`
`text_input`	`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" } ] } }`
`selection_input`	`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 } ] }`
`date_time_picker`	`DateTimePicker` ユーザーが日付、時刻、または日付と時刻を入力できるウィジェットを表示します。たとえば、次の JSON は、予約をスケジュールするための日時選択ツールを作成します。 `"dateTimePicker": { "name": "appointment_time", "label": "Book your appointment at:", "type": "DATE_AND_TIME", "valueMsEpoch": 796435200000 }`
`divider`	`Divider` ウィジェット間に水平線の区切り線を表示します。たとえば、次の JSON は区切り線を作成します。 `"divider": { }`
`grid`	`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`	`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" } } ] } ] }`
`carousel`	`Carousel` カルーセルには、ネストされたウィジェットのコレクションが含まれています。たとえば、2 つのテキスト段落を含むカルーセルの JSON 表現は次のようになります。 `{ "widgets": [ { "textParagraph": { "text": "First text paragraph in the carousel." } }, { "textParagraph": { "text": "Second text paragraph in the carousel." } } ] }`
`chip_list`	`ChipList` チップのリスト。たとえば、次の JSON は 2 つのチップを作成します。1 つ目はテキストチップ、2 つ目はリンクを開くアイコンチップです。 `"chipList": { "chips": [ { "text": "Edit", "disabled": true, }, { "icon": { "knownIcon": "INVITE", "altText": "check calendar" }, "onClick": { "openLink": { "url": "https://example.com/calendar" } } } ] }`

HorizontalAlignment

列挙型
`HORIZONTAL_ALIGNMENT_UNSPECIFIED`	使用しないでください。指定なし。
`START`	デフォルト値。ウィジェットを列の開始位置に配置します。左から右のレイアウトの場合、左に揃えます。右から左のレイアウトの場合、右揃えになります。
`CENTER`	ウィジェットを列の中央に配置します。
`END`	ウィジェットを列の末尾に配置します。左から右のレイアウトの場合、ウィジェットを右に配置します。右から左のレイアウトの場合、ウィジェットを左に配置します。

ImageType

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

VerticalAlignment

列挙型
`VERTICAL_ALIGNMENT_UNSPECIFIED`	タイプの指定なし。使用しないでください。
`TOP`	上部に配置します。
`MIDDLE`	中央位置に合わせます。
`BOTTOM`	下部に配置します。

Package google.apps.card.v1 コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

インデックス

アクション

ActionParameter

インタラクション

LoadIndicator

BorderStyle

BorderType

ボタン

タイプ

ButtonList

カード

CardAction

CardFixedFooter

CardHeader

DisplayStyle

DividerStyle

NestedWidget

セクション

公開設定

カルーセル

CarouselCard

チップ

ChipList

レイアウト

CollapseControl

列

列

HorizontalSizeStyle

VerticalAlignment

ウィジェット

条件

ExpressionDataCondition

ConditionType

DataSourceConfig

DateTimePicker

DateTimePickerType

DecoratedText

SwitchControl

ControlType

分割線

EventAction

CommonWidgetAction

UpdateVisibilityAction

ExpressionData

グリッド

GridItem

GridItemLayout

アイコン

画像

ImageComponent

ImageCropStyle

ImageCropType

MaterialIcon

OnClick

OpenLink

OnClose

OpenAs

OverflowMenu

OverflowMenuItem

SelectionInput

PlatformDataSource

CommonDataSource

SelectionItem

SelectionType

候補

SuggestionItem

TextInput

タイプ

TextParagraph

TextSyntax

トリガー

検証

InputType

ウィジェット

HorizontalAlignment

ImageType

VerticalAlignment

Package google.apps.card.v1