このページは 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（メッセージ）
Carousel（メッセージ）
Carousel.CarouselCard（メッセージ）
Chip（メッセージ）
ChipList（メッセージ）
ChipList.Layout（列挙型）
CollapseControl（メッセージ）
Columns（メッセージ）
Columns.Column（メッセージ）
Columns.Column.HorizontalSizeStyle（列挙型）
Columns.Column.VerticalAlignment（列挙型）
Columns.Column.Widgets（メッセージ）
DataActions（メッセージ）
DateTimePicker（メッセージ）
DateTimePicker.DateTimePickerType（列挙型）
DecoratedText（メッセージ）
DecoratedText.SwitchControl（メッセージ）
DecoratedText.SwitchControl.ControlType（列挙型）
Divider（メッセージ）
EndNavigation（メッセージ）
EndNavigation.Action（列挙型）
GetAutocompletionResponse（メッセージ）
Grid（メッセージ）
Grid.GridItem（メッセージ）
Grid.GridItem.GridItemLayout（列挙型）
Icon（メッセージ）
Image（メッセージ）
ImageComponent（メッセージ）
ImageCropStyle（メッセージ）
ImageCropStyle.ImageCropType（列挙型）
Link（メッセージ）
LinkPreview（メッセージ）
MaterialIcon（メッセージ）
ModifyCard（メッセージ）
ModifyCard.UpdateWidget（メッセージ）
ModifyCard.UpdateWidget.SelectionInputWidgetSuggestions（メッセージ）
Navigation（メッセージ）
Notification（メッセージ）
OnClick（メッセージ）
OpenLink（メッセージ）
OpenLink.OnClose（列挙型）
OpenLink.OpenAs（列挙型）
OverflowMenu（メッセージ）
OverflowMenu.OverflowMenuItem（メッセージ）
RenderActions（メッセージ）
RenderActions.Action（メッセージ）
SelectionInput（メッセージ）
SelectionInput.PlatformDataSource（メッセージ）
SelectionInput.PlatformDataSource.CommonDataSource（列挙型）
SelectionInput.SelectionItem（メッセージ）
SelectionInput.SelectionType（列挙型）
SubmitFormResponse（メッセージ）
Suggestions（メッセージ）
Suggestions.SuggestionItem（メッセージ）
TextInput（メッセージ）
TextInput.Type（列挙型）
TextParagraph（メッセージ）
TextParagraph.TextSyntax（列挙型）
Validation（メッセージ）
Validation.InputType（列挙型）
Widget（メッセージ）
Widget.HorizontalAlignment（列挙型）
Widget.ImageType（列挙型）
Widget.VerticalAlignment（列挙型）

アクション

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

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

フィールド
`function`	`string` コンテナ要素がクリックされたとき、またはアクティブになったときに呼び出すカスタム関数。使用例については、フォームデータの読み取りをご覧ください。
`parameters[]`	`ActionParameter` アクションパラメータのリスト。
`loadIndicator`	`LoadIndicator` アクションの呼び出し中にアクションが表示する読み込みインジケーターを指定します。
`persistValues`	`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 アドオンでは利用できません。
`requiredWidgets[]`	`string` 省略可。このリストに、この Action が有効な送信に必要なウィジェットの名前を入力します。この Action が呼び出されたときに、ここにリストされているウィジェットに値がない場合、フォームの送信は中止されます。 Google Chat アプリと Google Workspace アドオンで利用できます。
`allWidgetsAreRequired`	`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` 枠線の種類。
`strokeColor`	`Color` タイプが `BORDER_TYPE_STROKE` の場合に使用する色。ストロークの色を設定するには、`red`、`green`、`blue` フィールドの値を指定します。値は RGB カラー値に基づく 0 ～ 1 の浮動小数点数でなければなりません。`0`（0/255）は色がないことを表し、`1`（255/255）は色の最大強度を表します。たとえば、次の例では、最大強度で色を赤に設定します。 `"color": { "red": 1, "green": 0, "blue": 0, }` ストロークの色には `alpha` フィールドを使用できません。指定した場合、このフィールドは無視されます。
`cornerRadius`	`int32` 枠線の角の半径。

type

BorderType

枠線の種類。

strokeColor

Color

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

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

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

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

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

cornerRadius

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` フィールドはボタンの色には使用できません。指定した場合、このフィールドは無視されます。
`onClick`	`OnClick` 必須。ユーザーがボタンをクリックしたときに実行するアクション（ハイパーリンクを開く、カスタム関数を実行するなど）。
`disabled`	`bool` `true` の場合、ボタンは非アクティブな状態で表示され、ユーザー操作に応答しません。
`altText`	`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 アプリの例については、カードのセクションを定義するをご覧ください。
`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` カードの名前。カードナビゲーションでカード識別子として使用されます。 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` アクション。

actionLabel

string

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

onClick

OnClick

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

CardFixedFooter

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

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

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

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

フィールド

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

primaryButton

Button

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

secondaryButton

Button

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

CardHeader

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

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

フィールド
`title`	`string` 必須。カードのヘッダーのタイトル。ヘッダーの高さは固定されています。タイトルとサブタイトルの両方が指定されている場合、それぞれ 1 行を占有します。タイトルのみが指定されている場合は、両方の行が使用されます。
`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`	設定されている場合、区切り線はレンダリングされません。このスタイルでは、レイアウトから区切り線が完全に削除されます。結果は、区切り線をまったく追加しない場合と同じになります。

NestedWidget

CarouselCard などのコンテナレイアウトに表示できるウィジェットのリスト。

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

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

セクション

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

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

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

カルーセル

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

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

{
  "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 アドオンでは利用できません。

フィールド

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

carouselCards[]

CarouselCard

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

CarouselCard

カルーセルアイテムとして表示できるカード。

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

フィールド

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

widgets[]

NestedWidget

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

footerWidgets[]

NestedWidget

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

チップ

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

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

フィールド
`icon`	`Icon` アイコン画像。`icon` と `text` の両方を設定すると、アイコンがテキストの前に表示されます。
`label`	`string` チップ内に表示されるテキスト。
`onClick`	`OnClick` 省略可。ユーザーがチップをクリックしたときに実行するアクション（ハイパーリンクを開く、カスタム関数を実行するなど）。
`enabled (deprecated)`	`bool` この項目は非推奨です。チップがアクティブな状態にあり、ユーザーアクションに応答するかどうか。デフォルトは `true` です。非推奨です。代わりに `disabled` を使用してください。
`disabled`	`bool` チップが非アクティブ状態であり、ユーザー操作を無視するかどうか。デフォルトは `false` です。
`altText`	`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 アドオンで利用できます。

フィールド

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

horizontalAlignment

HorizontalAlignment

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

expandButton

Button

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

collapseButton

Button

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

列

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

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

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

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

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

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

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

フィールド

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

columnItems[]

Column

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

列

列。

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

フィールド
`horizontalSizeStyle`	`HorizontalSizeStyle` 列がカードの幅を埋める方法を指定します。
`horizontalAlignment`	`HorizontalAlignment` ウィジェットを列の左、右、中央のいずれに配置するかを指定します。
`verticalAlignment`	`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` は次のいずれかになります。
`textParagraph`	`TextParagraph` `TextParagraph`ウィジェットです。
`image`	`Image` `Image`ウィジェットです。
`decoratedText`	`DecoratedText` `DecoratedText`ウィジェットです。
`buttonList`	`ButtonList` `ButtonList`ウィジェットです。
`textInput`	`TextInput` `TextInput`ウィジェットです。
`selectionInput`	`SelectionInput` `SelectionInput`ウィジェットです。
`dateTimePicker`	`DateTimePicker` `DateTimePicker`ウィジェットです。
`chipList`	`ChipList` `ChipList`ウィジェットです。

DataActions

Google Workspace データを更新するアドオンアクション。

フィールド

フィールド
`hostAppDataAction`	`HostAppDataActionMarkup` Google Workspace データを更新する方法を定義します。

hostAppDataAction

HostAppDataActionMarkup

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` ウィジェットが日付、時刻、または日付と時刻の入力をサポートしているかどうか。
`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` テキストの前に表示されるアイコン。
`startIconVerticalAlignment`	`VerticalAlignment` 省略可。開始アイコンの垂直方向の配置。設定しない場合、アイコンは垂直方向に中央揃えになります。 Google Chat アプリでは利用できますが、Google Workspace アドオンでは利用できません。
`topLabel`	`string` `text` の上に表示されるテキスト。常に切り捨てます。
`topLabelText`	`TextParagraph` `TextParagraph` は `top_label` と同等です。常に切り捨てます。`top_label` よりも複雑な形式設定が可能です。 Google Chat アプリでは利用できますが、Google Workspace アドオンでは利用できません。
`text`	`string` 必須。メインのテキスト。簡単な書式設定をサポートします。テキストの書式設定について詳しくは、Google Chat アプリでテキストの書式を設定すると Google Workspace アドオンでテキストの書式を設定するをご覧ください。
`contentText`	`TextParagraph` `TextParagraph` は `text` と同等です。`text` よりも複雑な形式設定が可能です。 Google Chat アプリでは利用できますが、Google Workspace アドオンでは利用できません。
`wrapText`	`bool` テキストの折り返し設定。`true` の場合、テキストは折り返されて複数行に表示されます。それ以外の場合、テキストは切り捨てられます。 `text` にのみ適用され、`topLabel` と `bottomLabel` には適用されません。
`bottomLabel`	`string` `text` の下に表示されるテキスト。常に折り返します。
`bottomLabelText`	`TextParagraph` `TextParagraph` は `bottom_label` と同等です。常に折り返します。`bottom_label` よりも複雑な形式設定が可能です。 Google Chat アプリでは利用できますが、Google Workspace アドオンでは利用できません。
`onClick`	`OnClick` このアクションは、ユーザーが `topLabel` または `bottomLabel` をクリックしたときにトリガーされます。
共用体フィールド `control`。`decoratedText` ウィジェットのテキストの右側に表示されるボタン、スイッチ、チェックボックス、画像。`control` は次のいずれかになります。
`button`	`Button` ユーザーがクリックしてアクションをトリガーできるボタン。
`switchControl`	`SwitchControl` ユーザーがクリックして状態を変更し、アクションをトリガーできるスイッチウィジェット。
`endIcon`	`Icon` テキストの後に表示されるアイコン。組み込みアイコンとカスタムアイコンをサポートします。

SwitchControl

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

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

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

フィールド
`name`	`string` フォーム入力イベントでスイッチウィジェットを識別する名前。フォーム入力の操作の詳細については、フォームデータを受け取るをご覧ください。
`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 のアドオンの場合、ダイアログを閉じます。

フィールド

action

Action

Google Chat のアドオンの場合、ダイアログを閉じるアクション。

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

アクション

Google Chat のアドオンの場合、ダイアログを閉じるアクション。

列挙型
`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` これは、構文チェックのマークアップに存在する可能性がある no-op スキーマフィールドです。

autoComplete

Suggestions

schema

string

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

グリッド

アイテムのコレクションを含むグリッドを表示します。項目にはテキストまたは画像のみを含めることができます。レスポンシブな列の場合や、テキストや画像以外のものを含める場合は、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` グリッドに表示するアイテム。
`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`	タイトルとサブタイトルは、グリッドアイテムの画像の上に表示されます。

アイコン

カードのウィジェットに表示されるアイコン。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/workspace/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/workspace/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/workspace/chat/images/quickstart-app-avatar.png`
`onClick`	`OnClick` ユーザーが画像をクリックすると、このアクションがトリガーされます。
`altText`	`string` ユーザー補助機能で使用されるこの画像の代替テキスト。

imageUrl

string

画像をホストする HTTPS URL。

次に例を示します。

https://developers.google.com/workspace/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 }`

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

リンク

アドオンに返されるサードパーティリソースのリンクオブジェクト。詳しくは、@ メニューからサードパーティのリソースを作成するをご覧ください。

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

フィールド

フィールド
`url`	`string` アドオンに戻るためのリンクの URL。
`title`	`string` アドオンに戻るためのリンクのタイトル。

url

string

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

title

string

アドオンに戻るためのリンクのタイトル。

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` リンクのプレビューのスマートチップに表示されるタイトル。設定されていない場合、スマートチップには `previewCard` のヘッダーが表示されます。
`linkPreviewTitle`	`string` リンクプレビューに表示されるタイトル。設定されていない場合、リンクのプレビューには `previewCard` のヘッダーが表示されます。

previewCard

Card

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

title

string

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

linkPreviewTitle

string

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

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

ModifyCard

Google Chat のアドオンの場合、ユーザーの操作に基づいてカードを更新します。配列には 1 つのオブジェクトのみを含める必要があります。

フィールド

フィールド
共用体フィールド `operation`。 `operation` は次のいずれかになります。
`updateWidget`	`UpdateWidget` Google Chat のアドオンの場合、カードまたはダイアログのウィジェットを更新します。

共用体フィールド operation。

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

updateWidget

UpdateWidget

Google Chat のアドオンの場合、カードまたはダイアログのウィジェットを更新します。

UpdateWidget

Google Chat のアドオンの場合、カードまたはダイアログのウィジェットを更新します。ユーザーが入力ボックスに入力したときに、予測入力の候補を表示するために使用されます。詳しくは、複数選択項目の候補を表示するをご覧ください。

フィールド

フィールド
共用体フィールド `updated_widget`。ウィジェットの更新。`updated_widget` は次のいずれかになります。
`selectionInputWidgetSuggestions`	`SelectionInputWidgetSuggestions` `selectionInput` ウィジェットの場合、複数選択メニューの候補項目の配列。マルチセレクトメニューで外部データソースを使用して項目を設定する場合、ユーザーがメニューに入力した内容に基づいて、ウィジェットで候補を動的に設定できます。詳しくは、Google Chat ユーザーから情報を収集するをご覧ください。デベロッパープレビュー: Google Workspace デベロッパープレビュープログラムの一部として利用できます。このプログラムでは、特定の機能にいち早くアクセスできます。

共用体フィールド updated_widget。ウィジェットの更新。updated_widget は次のいずれかになります。

selectionInputWidgetSuggestions

SelectionInputWidgetSuggestions

selectionInput ウィジェットの場合、複数選択メニューの候補項目の配列。マルチセレクトメニューで外部データソースを使用して項目を設定する場合、ユーザーがメニューに入力した内容に基づいて、ウィジェットで候補を動的に設定できます。詳しくは、Google Chat ユーザーから情報を収集するをご覧ください。

SelectionInputWidgetSuggestions

マルチセレクトメニューを使用する selectionInput ウィジェットの場合、外部の動的データソースから選択アイテムを返します。

フィールド

suggestions[]

SelectionItem

ユーザーが複数選択メニューに入力した後に表示される選択可能なアイテムの配列。

カードスタック内のカードを更新または移動します。

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` カードをカードスタックにプッシュします。 Google Chat のダイアログの場合、ダイアログを開くか更新します。
`updateCard`	`Card` 一番上のカードを新しいカードで更新し、入力済みのフォームフィールドの値を保持します。同等のフィールドでない場合、値は削除されます。 Google Chat のダイアログの場合、ダイアログを開くか更新します。
`endNavigation`	`EndNavigation` Google Chat のアドオンの場合、ダイアログを閉じます。デベロッパープレビュー: Google Workspace デベロッパープレビュープログラムの一部として利用できます。このプログラムでは、特定の機能にいち早くアクセスできます。

通知

ユーザーがカードを操作したときに、ホストの Google Workspace アプリケーションに通知を表示するアクション。

Google Chat のアドオンの場合、ユーザーがダイアログを送信して閉じると、通知が表示されます。

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

フィールド

text

string

HTML タグを含まない、通知に表示するプレーンテキスト。

OnClick

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

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

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

OpenLink

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

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

フィールド

url

string

開く URL。

openAs

OpenAs

リンクを開く方法。

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

onClose

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 アドオンで利用できます。

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

RenderActions

ユーザー操作に応じてカードをレンダリングしたりアクションを実行したりする方法をホストアプリに伝える一連のレンダリング手順。

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

フィールド

action

Action

アドオンが UI の更新に使用できるアクション。

Google Chat のアドオン。

hostAppAction

HostAppActionMarkup

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

schema

string

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

アクション

アドオンがカードまたはホストアプリケーションで使用できるアクション。

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

フィールド
`navigations[]`	`Navigation` カードをプッシュ、ポップ、更新します。 Google Chat のアドオン。
`link`	`OpenLink` リンク先を新しいタブまたはポップアップウィンドウで開きます。
`notification`	`Notification` ユーザーがカードを操作したときに、ホストの Google Workspace アプリケーションに通知を表示します。 Google Chat のアドオンの場合、ユーザーがダイアログを送信して閉じると、通知が表示されます。
`linkPreview`	`LinkPreview` Google ドキュメント、Google スプレッドシート、Google スライドで利用できます。スマートチップとカードを使用してリンクをプレビューします。詳しくは、スマートチップを使用してリンクをプレビューするをご覧ください。
`links[]`	`Link` Google ドキュメントで利用できます。サードパーティのリソースからリンクを返し、ホストアプリケーションでスマートチップに変換します。1 つの項目を含むオブジェクトの配列としてフォーマットされます。詳しくは、@ メニューからサードパーティのリソースを作成するをご覧ください。
`modifyOperations[]`	`ModifyCard` Google Chat のアドオンの場合、ユーザーの操作に基づいてカードを更新します。配列には 1 つのオブジェクトのみを含める必要があります。

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 つ以上のチェックボックスを選択できますが、プルダウンメニューから選択できる値は 1 つだけです。
`items[]`	`SelectionItem` 選択可能なアイテムの配列。たとえば、ラジオボタンやチェックボックスの配列などです。最大 100 個のアイテムをサポートします。
`onChangeAction`	`Action` 指定されている場合、選択が変更されるとフォームが送信されます。指定しない場合は、フォームを送信する別のボタンを指定する必要があります。フォーム入力の操作の詳細については、フォームデータを受け取るをご覧ください。
`multiSelectMaxSelectedItems`	`int32` 複数選択メニューの場合、ユーザーが選択できるアイテムの最大数。最小値は 1 個です。指定しない場合、デフォルトは 3 個のアイテムです。
`multiSelectMinQueryLength`	`int32` 複数選択メニューの場合、メニューが候補の選択項目を返すまでにユーザーが入力するテキスト文字数。設定されていない場合、マルチセレクトメニューでは次のデフォルト値が使用されます。メニューで `SelectionInput` アイテムの静的配列を使用している場合、デフォルトは 0 文字で、配列からすぐにアイテムが入力されます。メニューで動的データソース（`multi_select_data_source`）を使用している場合、デフォルトでは、データソースにクエリを実行して候補アイテムを返す前に 3 文字が入力されます。
`hintText`	`string` 省略可。選択入力フィールドの下に表示されるテキスト。ユーザーが特定の値を入力するよう促すことで、ユーザーをサポートすることを目的としています。このテキストは常に表示されます。 Google Workspace Workflows でのみサポートされます。Google Chat API や Google Workspace アドオンではサポートされません。
共用体フィールド `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 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 つのアイテムに対してのみ設定します。
`bottomText`	`string` 複数選択メニューの場合、項目の `text` フィールドの下に表示されるテキストの説明またはラベル。
共用体フィールド `startIcon`。複数選択メニューの場合、アイテムの `text` フィールドの横に表示されるアイコンの URL。PNG ファイルと JPEG ファイルをサポートしています。`HTTPS` URL である必要があります。たとえば、`https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png` のようにします。`startIcon` は次のいずれかになります。
`startIconUri`	`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 アドオンで利用できます。

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

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

候補

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

たとえば、プログラミング言語のテキスト入力フィールドでは、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` が指定されていない場合は必須。それ以外の場合は省略可。
`hintText`	`string` テキスト入力フィールドの下に表示されるテキスト。ユーザーが特定の値を入力するよう促すことで、ユーザーをサポートすることを目的としています。このテキストは常に表示されます。 `label` が指定されていない場合は必須。それ以外の場合は省略可。
`value`	`string` ユーザーが入力した値。フォーム入力イベントの一部として返されます。フォーム入力の操作の詳細については、フォームデータを受け取るをご覧ください。
`type`	`Type` ユーザーインターフェースでのテキスト入力フィールドの表示方法。たとえば、フィールドが単一行か複数行かなどです。
`onChangeAction`	`Action` テキスト入力フィールドで変更が発生した場合の処理。たとえば、ユーザーがフィールドにテキストを追加したり、テキストを削除したりする場合です。実行するアクションの例としては、カスタム関数を実行する、Google Chat でダイアログを開くなどがあります。
`initialSuggestions`	`Suggestions` ユーザーが入力できる候補値。これらの値は、ユーザーがテキスト入力フィールド内をクリックすると表示されます。ユーザーが入力すると、入力内容に合わせて候補値が動的にフィルタされます。たとえば、プログラミング言語のテキスト入力フィールドでは、Java、JavaScript、Python、C++ が候補として表示されることがあります。ユーザーが `Jav` と入力し始めると、候補のリストがフィルタされ、`Java` と `JavaScript` のみが表示されます。候補値は、アプリが理解できる値をユーザーが入力できるようにするためのものです。JavaScript を参照する場合、`javascript` と入力するユーザーもいれば、`java script` と入力するユーザーもいます。`JavaScript` を提案することで、ユーザーがアプリを操作する方法を標準化できます。指定した場合、`TextInput.type` が `MULTIPLE_LINE` に設定されていても、常に `SINGLE_LINE` になります。 Google Chat アプリと Google Workspace アドオンで利用できます。
`autoCompleteAction`	`Action` 省略可。テキスト入力フィールドで、操作しているユーザーに候補を表示する際のアクションを指定します。指定しない場合、候補は `initialSuggestions` によって設定され、クライアントによって処理されます。指定されている場合、アプリはここで指定されたアクション（カスタム関数の実行など）を実行します。 Google Workspace アドオンでは利用できますが、Google Chat アプリでは利用できません。
`validation`	`Validation` このテキストフィールドに必要な入力形式の検証を指定します。 Google Chat アプリと Google Workspace アドオンで利用できます。
`placeholderText`	`string` フィールドが空の場合にテキスト入力フィールドに表示されるテキスト。このテキストを使用して、ユーザーに値を入力するよう促します。例: `Enter a number from 0 to 100` Google Chat アプリでは利用できますが、Google Workspace アドオンでは利用できません。

タイプ

ユーザーインターフェースでのテキスト入力フィールドの表示方法。たとえば、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

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

maxLines

int32

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

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

textSyntax

TextSyntax

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

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

TextSyntax

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

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

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

検証

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

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

フィールド

characterLimit

int32

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

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

inputType

InputType

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

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

InputType

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

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

フィールド
`horizontalAlignment`	`HorizontalAlignment` ウィジェットを列の左、右、中央のいずれに配置するかを指定します。
共用体フィールド `data`。ウィジェットには、次のいずれか 1 つのみを含めることができます。複数のウィジェットフィールドを使用して、より多くのアイテムを表示できます。`data` は次のいずれかになります。
`textParagraph`	`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" }`
`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, }, "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` アイテムのコレクションを含むグリッドを表示します。グリッドは任意の数の列とアイテムをサポートします。行数は、アイテム数の上限を列数で割った値によって決まります。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." } } ] }`
`chipList`	`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

ウィジェット

DataActions

DateTimePicker

DateTimePickerType

DecoratedText

SwitchControl

ControlType

分割線

EndNavigation

アクション

GetAutocompletionResponse

グリッド

GridItem

GridItemLayout

アイコン

画像

ImageComponent

ImageCropStyle

ImageCropType

リンク

LinkPreview

MaterialIcon

ModifyCard

UpdateWidget

SelectionInputWidgetSuggestions

ナビゲーション

通知

OnClick

OpenLink

OnClose

OpenAs

OverflowMenu

OverflowMenuItem

RenderActions

アクション

SelectionInput

PlatformDataSource

CommonDataSource

SelectionItem

SelectionType

SubmitFormResponse

候補

SuggestionItem

TextInput

タイプ

TextParagraph

TextSyntax

検証

InputType

ウィジェット

HorizontalAlignment

Package google.apps.card.v1