目次
Action
(メッセージ)Action.ActionParameter
(メッセージ)Action.Interaction
(列挙型)Action.LoadIndicator
(列挙型)BorderStyle
(メッセージ)BorderStyle.BorderType
(列挙型)Button
(メッセージ)ButtonList
(メッセージ)Card
(メッセージ)Card.CardAction
(メッセージ)Card.CardFixedFooter
(メッセージ)Card.CardHeader
(メッセージ)Card.DisplayStyle
(列挙型)Card.DividerStyle
(列挙型)Card.Section
(メッセージ)Columns
(メッセージ)Columns.Column
(メッセージ)Columns.Column.HorizontalSizeStyle
(列挙型)Columns.Column.VerticalAlignment
(列挙型)Columns.Column.Widgets
(メッセージ)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
(メッセージ)Navigation
(メッセージ)Notification
(メッセージ)OnClick
(メッセージ)OpenLink
(メッセージ)OpenLink.OnClose
(列挙型)OpenLink.OpenAs
(列挙型)RenderActions
(メッセージ)RenderActions.Action
(メッセージ)SelectionInput
(メッセージ)SelectionInput.PlatformDataSource
(メッセージ)SelectionInput.PlatformDataSource.CommonDataSource
(列挙型)SelectionInput.SelectionItem
(メッセージ)SelectionInput.SelectionType
(列挙型)SubmitFormResponse
(メッセージ)Suggestions
(メッセージ)Suggestions.SuggestionItem
(メッセージ)TextInput
(メッセージ)TextInput.Type
(列挙型)TextParagraph
(メッセージ)Widget
(メッセージ)Widget.HorizontalAlignment
(列挙型)Widget.ImageType
(列挙型)
アクション
フォーム送信時の動作を記述するアクション。たとえば、Apps Script のスクリプトを呼び出してフォームを処理できます。アクションがトリガーされると、フォームの値がサーバーに送信されます。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
フィールド | |
---|---|
function |
含まれる要素がクリックされたとき、または他の要素がアクティブになったときに呼び出すカスタム関数。 使用例については、インタラクティブなカードを作成するをご覧ください。 |
parameters[] |
アクション パラメータのリスト。 |
loadIndicator |
アクションの呼び出し中にアクションが表示する読み込みインジケーターを指定します。 |
persistValues |
フォームの値がアクションの後も保持されるかどうかを示します。デフォルト値は
|
interaction |
省略可。ダイアログを開く場合は必要です。 ユーザーとのやり取り(カード メッセージのボタンのクリックなど)に対する処理。 指定しない場合、アプリは通常どおり
Google Chat アプリで利用できますが、Google Workspace アドオンでは利用できません。 |
ActionParameter
アクション メソッドが呼び出されたときに提供する文字列パラメータのリスト。たとえば、今すぐスヌーズ、1 日だけスヌーズ、来週の 3 つのスヌーズ ボタンを考えてみます。action method = snooze()
を使用して、スヌーズの種類と時間を文字列パラメータのリストに渡します。
詳しくは、CommonEventObject
をご覧ください。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
フィールド | |
---|---|
key |
アクション スクリプトのパラメータの名前。 |
value |
パラメータの値。 |
インタラクション
省略可。ダイアログを開く場合は必要です。
ユーザーとのやり取り(カード メッセージのボタンのクリックなど)に対する処理。
指定しない場合、アプリは通常どおり action
を実行して(リンクのオープンや関数の実行など)、応答します。
interaction
を指定することで、アプリは特別なインタラクティブな方法で応答できます。たとえば、interaction
を OPEN_DIALOG
に設定すると、アプリでダイアログを開くことができます。
指定すると、読み込みインジケーターは表示されません。アドオンに指定すると、カード全体が削除され、クライアントには何も表示されません。
Google Chat アプリで利用できますが、Google Workspace アドオンでは利用できません。
列挙型 | |
---|---|
INTERACTION_UNSPECIFIED |
デフォルト値。action は通常どおり実行されます。 |
OPEN_DIALOG |
ダイアログを開きます。ダイアログは、Chat アプリがユーザーとやり取りする際に使用する、ウィンドウ形式のカードベースのインターフェースです。 カード メッセージのボタンクリックに応答する Chat アプリでのみサポートされます。アドオンに指定すると、カード全体が削除され、クライアントには何も表示されません。 Google Chat アプリで利用できますが、Google Workspace アドオンでは利用できません。 |
LoadIndicator
アクションの呼び出し中にアクションが表示する読み込みインジケーターを指定します。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
列挙型 | |
---|---|
SPINNER |
コンテンツが読み込み中であることを示すスピナーが表示されます。 |
NONE |
何も表示されません。 |
BorderStyle
カードまたはウィジェットの枠線のスタイル オプション(枠線の種類や色など)。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
フィールド | |
---|---|
type |
枠線の種類。 |
strokeColor |
タイプが |
cornerRadius |
枠線の角の丸み。 |
BorderType
ウィジェットに適用される枠線の種類を表します。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
列挙型 | |
---|---|
BORDER_TYPE_UNSPECIFIED |
使用しないでください。(指定なし) |
NO_BORDER |
デフォルト値。枠線なし。 |
STROKE |
概要。 |
ボタン
ユーザーがクリックできるテキスト、アイコン、テキストとアイコンのボタン。Google Chat アプリの例については、ボタンリストをご覧ください。
画像をクリック可能なボタンにするには、
(Image
ではない)を指定し、ImageComponent
onClick
アクションを設定します。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
フィールド | |
---|---|
text |
ボタン内に表示されるテキスト。 |
icon |
アイコン画像。 |
color |
設定すると、ボタンは無地の背景色で塗りつぶされ、フォントの色が変化して背景色とのコントラストが維持されます。たとえば、青い背景を設定すると、白いテキストになります。 設定しない場合、画像の背景は白、フォントの色は青になります。 赤、緑、青の場合、各フィールドの値は 必要に応じて
たとえば、次の色は半透明の赤を表しています。
|
onClick |
必須。ハイパーリンクの表示やカスタム関数の実行など、ユーザーがボタンをクリックしたときに実行するアクション。 |
disabled |
|
altText |
ユーザー補助に使用される代替テキスト。 ボタンの機能をユーザーに伝える説明テキストを設定します。たとえば、ボタンによってハイパーリンクが開く場合は、「新しいブラウザタブが開き、Google Chat のデベロッパー向けドキュメント(https://developers.google.com/chat")に移動します」と入力します。 |
ButtonList
横方向にレイアウトされたボタンのリスト。Google Chat アプリの例については、ボタンリストをご覧ください。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
フィールド | |
---|---|
buttons[] |
ボタンの配列。 |
カード
Google Chat のメッセージまたは Google Workspace アドオンに表示されているカード インターフェース。
カードでは、定義済みのレイアウト、ボタンなどのインタラクティブな UI 要素、画像などのリッチメディアがサポートされます。カードを使用して詳細情報を表示し、ユーザーから情報を収集して、ユーザーを次のステップに導きます。
カードビルダーでカードをデザインしてプレビューする。
カードビルダーを開くカードの作成方法については、次のドキュメントをご覧ください。
- Google Chat アプリについては、カードを使用して動的でインタラクティブで一貫性のある UI を設計するをご覧ください。
- Google Workspace アドオンについては、カードベースのインターフェースをご覧ください。
例: Google Chat アプリのカード メッセージ
Google Chat でサンプルのカード メッセージを作成するには、次の JSON を使用します。
{
"cardsV2": [
{
"cardId": "unique-card-id",
"card": {
"header": {
"title": "Sasha",
"subtitle": "Software Engineer",
"imageUrl":
"https://developers.google.com/chat/images/quickstart-app-avatar.png",
"imageType": "CIRCLE",
"imageAltText": "Avatar for Sasha"
},
"sections": [
{
"header": "Contact Info",
"collapsible": true,
"uncollapsibleWidgetsCount": 1,
"widgets": [
{
"decoratedText": {
"startIcon": {
"knownIcon": "EMAIL"
},
"text": "sasha@example.com"
}
},
{
"decoratedText": {
"startIcon": {
"knownIcon": "PERSON"
},
"text": "<font color=\"#80e27e\">Online</font>"
}
},
{
"decoratedText": {
"startIcon": {
"knownIcon": "PHONE"
},
"text": "+1 (555) 555-1234"
}
},
{
"buttonList": {
"buttons": [
{
"text": "Share",
"onClick": {
"openLink": {
"url": "https://example.com/share"
}
}
},
{
"text": "Edit",
"onClick": {
"action": {
"function": "goToView",
"parameters": [
{
"key": "viewType",
"value": "EDIT"
}
]
}
}
}
]
}
}
]
}
]
}
}
]
}
フィールド | |
---|---|
header |
カードのヘッダー。ヘッダーには通常、先頭の画像とタイトルが含まれます。ヘッダーは常にカードの上部に表示されています。 |
sections[] |
ウィジェットのコレクションが含まれています。各セクションには、独自のオプションのヘッダーがあります。セクションは線の区切りで視覚的に区切られています。Google Chat アプリの例については、カード セクションをご覧ください。 |
sectionDividerStyle |
セクション間の分割線。 |
cardActions[] |
カードの操作。操作はカードのツールバー メニューに追加されます。 Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。 たとえば、次の JSON は、
|
name |
カードの名前。カード ナビゲーションでカード ID として使用されます。 Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。 |
fixedFooter |
このカードの下部に表示される固定フッター。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。 |
displayStyle |
Google Workspace アドオンで、 Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。 |
peekCardHeader |
コンテキスト コンテンツを表示する際、ピークカード ヘッダーはプレースホルダの役割を果たし、ユーザーはホームページ カードとコンテキスト カード間を移動できます。 Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。 |
CardAction
カード アクションとは、カードに関連付けられているアクションのことです。たとえば、請求書カードには、請求書を削除する、請求書をメールで送信する、ブラウザで請求書を開くなどのアクションを含めることができます。
Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。
フィールド | |
---|---|
actionLabel |
アクション メニュー項目として表示されるラベル。 |
onClick |
このアクション アイテムの |
CardHeader
カードヘッダーを表します。Google Chat アプリの例については、カードヘッダーをご覧ください。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
フィールド | |
---|---|
title |
必須。カードヘッダーのタイトル。ヘッダーの高さは固定されます。タイトルとサブタイトルの両方が指定されている場合、それぞれが 1 行を占めます。タイトルのみを指定すると、2 行が使用されます。 |
subtitle |
カードヘッダーのサブタイトル。指定すると、 |
imageType |
画像の切り抜きに使用する形状。 Google Chat アプリと Google Workspace アドオンでご利用いただけます。 |
imageUrl |
カードヘッダーの画像の HTTPS URL。 |
imageAltText |
ユーザー補助に使用される、この画像の代替テキスト。 |
DisplayStyle
Google Workspace アドオンでは、カードの表示方法を決定します。
Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。
列挙型 | |
---|---|
DISPLAY_STYLE_UNSPECIFIED |
使用しないでください。(指定なし) |
PEEK |
カードのヘッダーはサイドバーの下部に表示され、スタックの現在の一番上のカードの一部の上に重ねて表示されます。ヘッダーをクリックすると、カードがカードスタックにポップされます。カードにヘッダーがない場合は、生成されたヘッダーが代わりに使用されます。 |
REPLACE |
デフォルト値。カードスタック内の一番上のカードのビューを置き換えることで、カードが表示されます。 |
DividerStyle
カードの分割線スタイル。現時点では、カード セクション間の分割線にのみ使用されます。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
列挙型 | |
---|---|
DIVIDER_STYLE_UNSPECIFIED |
使用しないでください。(指定なし) |
SOLID_DIVIDER |
デフォルトのオプション。セクション間の強固な分割線をレンダリングします。 |
NO_DIVIDER |
設定すると、セクション間の分割線はレンダリングされません。 |
セクション
1 つのセクションには、指定された順序で垂直方向にレンダリングされるウィジェットのコレクションが含まれます。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
フィールド | |
---|---|
header |
セクションの上部に表示されるテキスト。シンプルな HTML 形式のテキストをサポートします。テキストの書式設定について詳しくは、Google Chat アプリでのテキストの書式設定と Google Workspace アドオンでのテキストの書式設定をご覧ください。 |
widgets[] |
セクションのすべてのウィジェットです。ウィジェットを少なくとも 1 つ含める必要があります。 |
collapsible |
このセクションが折りたたみ可能かどうかを示します。 折りたたみ可能なセクションでは、一部またはすべてのウィジェットが非表示になりますが、[もっと見る] をクリックすると、セクションを展開して非表示のウィジェットを表示できます。[一部を表示] をクリックすると、ウィジェットを再度非表示にできます。 非表示にするウィジェットを指定するには、 |
uncollapsibleWidgetsCount |
セクションを折りたたんでも表示されている折りたたみできないウィジェットの数。 たとえば、セクションに 5 つのウィジェットがあり、 |
表示項目
Columns
ウィジェットでは、カードまたはダイアログに最大 2 列が表示されます。各列にウィジェットを追加できます。ウィジェットは指定された順序で表示されます。Google Chat アプリの例については、列をご覧ください。
各列の高さは、背の高い列によって決まります。たとえば、最初の列が 2 番目の列よりも高い場合、どちらの列も最初の列の高さになります。各列に含めることができるウィジェットの数は異なるため、行を定義したり、列間でウィジェットを配置したりすることはできません。
列は並べて表示されます。各列の幅は HorizontalSizeStyle
フィールドを使用してカスタマイズできます。ユーザーの画面幅が小さすぎる場合、2 番目の列は 1 番目の列より下に折り返されます。
- ウェブでは、画面幅が 480 ピクセル以下の場合、2 列目が折り返されます。
- iOS デバイスでは、画面の幅が 300 pt 以下の場合、2 列目が折り返されます。
- Android デバイスでは、画面幅が 320 dp 以下の場合、2 列目が折り返されます。
3 つ以上の列を含める、または行を使用する場合は、
ウィジェットを使用します。Grid
Google Chat アプリと Google Workspace アドオンでご利用いただけます。Google Workspace アドオンの列はデベロッパー プレビューです。
フィールド | |
---|---|
columnItems[] |
列の配列。カードまたはダイアログには最大 2 列を含めることができます。 |
列
列。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。Google Workspace アドオンの列はデベロッパー プレビューです。
フィールド | |
---|---|
horizontalSizeStyle |
カードの幅を列で埋める方法を指定します。 |
horizontalAlignment |
ウィジェットを列の左、右、中央に揃えるかどうかを指定します。 |
verticalAlignment |
ウィジェットを列の上部、下部、または中央に配置するかどうかを指定します。 |
widgets[] |
列に含まれるウィジェットの配列。ウィジェットは指定された順序で表示されます。 |
HorizontalSizeStyle
カードの幅を列で埋める方法を指定します。各列の幅は、HorizontalSizeStyle
と、列内のウィジェットの幅の両方に依存します。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。Google Workspace アドオンの列はデベロッパー プレビューです。
列挙型 | |
---|---|
HORIZONTAL_SIZE_STYLE_UNSPECIFIED |
使用しないでください。(指定なし) |
FILL_AVAILABLE_SPACE |
デフォルト値。列は利用可能なスペース(カードの幅の 70% まで)全体に表示されます。両方の列が FILL_AVAILABLE_SPACE に設定されている場合、各列がスペースの 50% を占めます。 |
FILL_MINIMUM_SPACE |
列が占めるスペースは最小であり、カードの幅の 30% 以下であること。 |
VerticalAlignment
ウィジェットを列の上部、下部、または中央に配置するかどうかを指定します。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。Google Workspace アドオンの列はデベロッパー プレビューです。
列挙型 | |
---|---|
VERTICAL_ALIGNMENT_UNSPECIFIED |
使用しないでください。(指定なし) |
CENTER |
デフォルト値。ウィジェットを列の中央に揃えます。 |
TOP |
ウィジェットを列の上部に配置します。 |
BOTTOM |
ウィジェットを列の下部に揃えます。 |
ウィジェット
列に含めることができる、サポートされているウィジェット。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。Google Workspace アドオンの列はデベロッパー プレビューです。
フィールド | |
---|---|
共用体フィールド
|
|
textParagraph |
|
image |
|
decoratedText |
|
buttonList |
|
textInput |
|
selectionInput |
|
dateTimePicker |
|
DateTimePicker
日付、時刻、またはその両方を入力できます。Google Chat アプリの例については、日時選択ツールをご覧ください。
ユーザーはテキストを入力するか、選択ツールを使用して日付と時刻を選択できます。ユーザーが無効な日時を入力した場合、選択ツールにエラーが表示され、ユーザーに情報を正しく入力するよう促します。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
フィールド | |
---|---|
name |
フォーム入力イベントで フォーム入力の操作について詳しくは、フォームデータを受信するをご覧ください。 |
label |
日付、時刻、または日時の入力を求めるテキスト。たとえば、ユーザーが予約を設定する場合は、「 |
type |
ウィジェットが日付、時刻、または日付と時刻の入力をサポートしているかどうか。 |
valueMsEpoch |
ウィジェットに表示されるデフォルト値(Unix エポック時間からのミリ秒数)。 選択ツールのタイプ(
|
timezoneOffsetDate |
UTC からのタイムゾーン オフセットを表す数値(分単位)。設定すると、 |
onChangeAction |
ユーザーが |
DateTimePickerType
DateTimePicker
ウィジェットの日付と時刻の形式。ユーザーが日付、時刻、または日付と時刻の両方を入力できるようにするかどうかを指定します。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
列挙型 | |
---|---|
DATE_AND_TIME |
ユーザーが日時を入力します。 |
DATE_ONLY |
ユーザーが日付を入力します。 |
TIME_ONLY |
ユーザーが時刻を入力します。 |
DecoratedText
テキストの上または下にラベル、テキストの前にアイコン、選択ウィジェット、テキストの後にボタンなど、オプションの装飾を付けてテキストを表示するウィジェット。Google Chat アプリの例については、装飾テキストをご覧ください。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
フィールド | |
---|---|
icon |
非推奨になり、 |
startIcon |
テキストの前に表示されるアイコン。 |
topLabel |
|
text |
必須。メインのテキスト。 シンプルな書式設定をサポートします。テキストの書式設定について詳しくは、Google Chat アプリでのテキストの書式設定と Google Workspace アドオンでのテキストの書式設定をご覧ください。 |
wrapText |
テキストの折り返しの設定。
|
bottomLabel |
|
onClick |
このアクションは、ユーザーが |
共用体フィールド control 。decoratedText ウィジェットのテキストの右側に表示されるボタン、スイッチ、チェックボックス、または画像。control は次のいずれかになります。 |
|
button |
ユーザーがクリックしてアクションをトリガーできるボタン。 |
switchControl |
ユーザーがクリックすると、状態を変更し、アクションをトリガーできる switch ウィジェットです。 |
endIcon |
テキストの後に表示されるアイコン。 |
SwitchControl
切り替えスタイルのスイッチ、または decoratedText
ウィジェット内のチェックボックス。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
decoratedText
ウィジェットでのみサポートされます。
フィールド | |
---|---|
name |
フォーム入力イベントで switch ウィジェットを識別するための名前。 フォーム入力の操作について詳しくは、フォームデータを受信するをご覧ください。 |
value |
ユーザーが入力した値。フォーム入力イベントの一部として返されます。 フォーム入力の操作について詳しくは、フォームデータを受信するをご覧ください。 |
selected |
|
onChangeAction |
スイッチの状態が変更されたときに実行するアクション(実行する関数など)。 |
controlType |
ユーザー インターフェースにスイッチがどのように表示されるか。 Google Chat アプリと Google Workspace アドオンでご利用いただけます。 |
ControlType
ユーザー インターフェースにスイッチがどのように表示されるか。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
列挙型 | |
---|---|
SWITCH |
切り替えスタイルのスイッチ。 |
CHECKBOX |
非推奨になり、CHECK_BOX に置き換えられました。 |
CHECK_BOX |
チェックボックス。 |
分割線
このタイプにはフィールドがありません。
ウィジェット間の分割線を水平線で表示します。Google Chat アプリの例については、分割線をご覧ください。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
たとえば、次の JSON は分割線を作成します。
"divider": {}
GetAutocompletionResponse
オートコンプリート コンテナの取得に対するレスポンス。テキスト フィールドのオートコンプリート アイテムを表示するために必要な要素が含まれています。
Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。次に例を示します。
{
"autoComplete": {
"items": [
{
"text": "C++"
},
{
"text": "Java"
},
{
"text": "JavaScript"
},
{
"text": "Python"
}
]
}
}
フィールド | |
---|---|
autoComplete |
|
schema |
これは、構文チェックのためにマークアップに存在する可能性がある NoOps スキーマ フィールドです。 |
GRid
アイテムのコレクションをグリッドに表示します。アイテムに含めることができるのは、テキストまたは画像のみです。レスポンシブ列の場合、またはテキストや画像以外の要素を含める場合は、
を使用します。Google Chat アプリの例については、グリッドをご覧ください。Columns
グリッドは任意の数の列とアイテムをサポートします。行数は、項目を列数で割った値です。2 つの列に 10 個の項目があるグリッドには 5 行あります。11 個の項目と 2 列のグリッドには 6 行あります。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
たとえば、次の JSON は 1 つのアイテムを含む 2 列のグリッドを作成します。
"grid": {
"title": "A fine collection of items",
"columnCount": 2,
"borderStyle": {
"type": "STROKE",
"cornerRadius": 4
},
"items": [
{
"image": {
"imageUri": "https://www.example.com/image.png",
"cropStyle": {
"type": "SQUARE"
},
"borderStyle": {
"type": "STROKE"
}
},
"title": "An item",
"textAlignment": "CENTER"
}
],
"onClick": {
"openLink": {
"url": "https://www.example.com"
}
}
}
フィールド | |
---|---|
title |
グリッドのヘッダーに表示されるテキスト。 |
items[] |
グリッドに表示するアイテム。 |
borderStyle |
各グリッド アイテムに適用する枠線のスタイル。 |
columnCount |
グリッドに表示する列数です。このフィールドが指定されていない場合はデフォルト値が使用されます。デフォルト値は、グリッドが表示される場所(ダイアログまたはコンパニオン)によって異なります。 |
onClick |
このコールバックは、個々のグリッド アイテムで再利用されますが、アイテムリストのアイテムの識別子とインデックスがコールバックのパラメータに追加されます。 |
GridItem
グリッド レイアウトのアイテムを表します。アイテムには、テキスト、画像、またはテキストと画像の両方を含めることができます。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
フィールド | |
---|---|
id |
このグリッド アイテムのユーザー指定の識別子。この識別子は、親グリッドの |
image |
グリッド アイテムに表示される画像。 |
title |
グリッド アイテムのタイトル。 |
subtitle |
グリッド アイテムのサブタイトル。 |
layout |
グリッド アイテムに使用するレイアウト。 |
GridItemLayout
グリッド アイテムで利用可能なさまざまなレイアウト オプションを表します。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
列挙型 | |
---|---|
GRID_ITEM_LAYOUT_UNSPECIFIED |
使用しないでください。(指定なし) |
TEXT_BELOW |
タイトルとサブタイトルは、グリッド アイテムの画像の下に表示されます。 |
TEXT_ABOVE |
タイトルとサブタイトルは、グリッド アイテムの画像の上に表示されます。 |
Icon
カード上のウィジェットに表示されるアイコン。Google Chat アプリの例については、アイコンをご覧ください。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
フィールド | |
---|---|
altText |
省略可。ユーザー補助に使用されるアイコンの説明。指定しない場合は、デフォルト値の アイコンが |
imageType |
画像に適用される切り抜きスタイル。 |
共用体フィールド icons 。カード上のウィジェットに表示されるアイコン。icons は次のいずれかになります。 |
|
knownIcon |
Google Workspace に組み込まれているアイコンのいずれかを表示します。 たとえば、飛行機アイコンを表示するには、 サポートされているアイコンの完全なリストについては、組み込みアイコンをご覧ください。 |
iconUrl |
HTTPS URL でホストされているカスタム アイコンを表示します。 次に例を示します。
サポートされているファイル形式は |
materialIcon |
Google マテリアル アイコンのいずれかを表示します。 たとえば、チェックボックス アイコンを表示するには、次のコマンドを使用します。
Google Chat アプリで利用できますが、Google Workspace アドオンでは利用できません。 |
画像
URL で指定される画像。onClick
アクションを設定できます。例については、イメージをご覧ください。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
フィールド | |
---|---|
imageUrl |
イメージをホストする HTTPS URL。 次に例を示します。
|
onClick |
ユーザーが画像をクリックすると、このアクションがトリガーされます。 |
altText |
ユーザー補助に使用される、この画像の代替テキスト。 |
ImageComponent
画像を表します。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
フィールド | |
---|---|
imageUri |
画像の URL。 |
altText |
画像のユーザー補助ラベル。 |
cropStyle |
画像に適用する切り抜きスタイル。 |
borderStyle |
画像に適用する枠線のスタイル。 |
ImageCropStyle
画像に適用される切り抜きスタイルを表します。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
たとえば、16:9 のアスペクト比を適用する方法は次のとおりです。
cropStyle {
"type": "RECTANGLE_CUSTOM",
"aspectRatio": 16/9
}
フィールド | |
---|---|
type |
切り抜きタイプ。 |
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 |
アドオンに戻るリンクの URL。 |
title |
アドオンに戻るリンクのタイトル。 |
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 |
第三者サービスからのリンクに関する情報を表示するカード。 |
title |
リンク プレビューのスマートチップに表示されるタイトル。設定しない場合、スマートチップは |
linkPreviewTitle |
リンク プレビューに表示されるタイトル。設定しない場合、リンク プレビューには |
MaterialIcon
Google マテリアル アイコン: 2, 500 以上のオプションが含まれています。
たとえば、カスタマイズされた体重と成績のチェックボックス アイコンを表示するには、次のように記述します。
{
"name": "check_box",
"fill": true,
"weight": 300,
"grade": -25
}
Google Chat アプリで利用できますが、Google Workspace アドオンでは利用できません。
フィールド | |
---|---|
name |
Google マテリアル アイコンで定義されたアイコン名(例: |
fill |
アイコンが塗りつぶされた状態でレンダリングされるかどうか。デフォルト値は false です。 さまざまなアイコン設定をプレビューするには、[Google Font Icons] に移動し、[カスタマイズ] で設定を調整します。 |
weight |
アイコンのストロークの太さ。{100、200、300、400、500、600、700} から選択できます。指定されていない場合、デフォルト値は 400 です。他の値を指定すると、デフォルト値が使用されます。 さまざまなアイコン設定をプレビューするには、[Google Font Icons] に移動し、[カスタマイズ] で設定を調整します。 |
grade |
重量とグレードはシンボルの太さに影響します。グレードの調整は、太さの調整よりも細かい粒度で、記号のサイズへの影響は小さくなります。{-25, 0, 200} から選択できます。指定されていない場合、デフォルト値は 0 です。他の値を指定すると、デフォルト値が使用されます。 さまざまなアイコン設定をプレビューするには、[Google Font Icons] に移動し、[カスタマイズ] で設定を調整します。 |
通知
ホストアプリに通知を表示するカード アクション。
Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。
フィールド | |
---|---|
text |
通知に表示する書式なしテキスト(HTML タグなし)。 |
OnClick
ユーザーがカードのインタラクティブな要素(ボタンなど)をクリックしたときに応答する方法を表します。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
フィールド | |
---|---|
共用体フィールド
|
|
action |
指定すると、この |
openLink |
指定すると、この |
openDynamicLinkAction |
アクションでリンクを開く必要がある場合、アドオンによってこのアクションがトリガーされます。これは、リンクを取得するためにサーバーと通信する必要があるという点で、上記の Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。 |
card |
新しいカードは、指定された場合、クリックした後にカードスタックにプッシュされます。 Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。 |
OpenLink
ハイパーリンクを開く onClick
イベントを表します。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
フィールド | |
---|---|
url |
開く URL。 |
openAs |
リンクを開く方法 Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。 |
onClose |
クライアントがリンクを開いた後にリンクを忘れたか、またはウィンドウが閉じるまでリンクを監視したか。 Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。 |
OnClose
OnClick
アクションによって開かれたリンクが閉じられたときのクライアントの動作。
実装はクライアント プラットフォームの機能によって異なります。たとえば、ウェブブラウザが OnClose
ハンドラでポップアップ ウィンドウでリンクを開く場合があります。
OnOpen
ハンドラと OnClose
ハンドラの両方が設定され、クライアント プラットフォームが両方の値をサポートできない場合は、OnClose
が優先されます。
Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。
列挙型 | |
---|---|
NOTHING |
デフォルト値。カードは再読み込みされず、何も起こりません。 |
RELOAD |
子ウィンドウが閉じた後にカードを再読み込みします。
|
OpenAs
OnClick
アクションでリンクが開くと、クライアントはそのリンクをフルサイズのウィンドウ(クライアントが使用するフレームの場合)またはオーバーレイ(ポップアップなど)として開くことができます。実装はクライアント プラットフォームの機能に依存し、クライアントがサポートしていない場合、選択した値が無視されることがあります。FULL_SIZE
はすべてのクライアントでサポートされています。
Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。
列挙型 | |
---|---|
FULL_SIZE |
フルサイズ ウィンドウとしてリンクが開きます(クライアントで使用されているフレームの場合)。 |
OVERLAY |
ポップアップなどのオーバーレイとしてリンクが開きます。 |
RenderActions
カードにアクションの実行を指示する、またはアドオン ホストアプリまたは Chat アプリにアプリ固有のアクションを実行するよう指示する、レンダリングの手順のセット。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
フィールド | |
---|---|
action |
|
hostAppAction |
個々のホストアプリによって処理されるアクション。 |
schema |
これは、構文チェックのためにマークアップに存在する可能性がある NoOps スキーマ フィールドです。 |
アクション
フィールド | |
---|---|
navigations[] |
表示されたカードのプッシュ、ポップ、更新を行います。 |
link |
すぐに新しいタブまたはポップアップでターゲット リンクを開きます。 |
notification |
エンドユーザーに通知を表示します。 |
linkPreview |
エンドユーザーにリンク プレビューを表示します。 |
links[] |
Google Workspace アプリケーション内で作成されたサードパーティ リソースへのリンク。1 つの項目を含むオブジェクトの配列としてフォーマットされます。詳細については、@ メニューからサードパーティ リソースを作成するをご覧ください。 |
SelectionInput
ユーザーが選択できる 1 つ以上の UI アイテムを作成するウィジェット。たとえば、プルダウン メニューやチェックボックスなどです。このウィジェットを使用して、予測または列挙が可能なデータを収集できます。Google Chat アプリの例については、選択入力をご覧ください。
チャットアプリは、ユーザーが選択または入力したアイテムの価値を処理できます。フォーム入力の操作について詳しくは、フォームデータを受信するをご覧ください。
未定義のデータまたは抽象データをユーザーから収集するには、TextInput
ウィジェットを使用します。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
フィールド | |
---|---|
name |
フォーム入力イベントで選択入力を識別する名前。 フォーム入力の操作について詳しくは、フォームデータを受信するをご覧ください。 |
label |
ユーザー インターフェースの選択入力フィールドの上に表示されるテキスト。 ユーザーがアプリに必要な情報を入力するのに役立つテキストを指定します。たとえば、ユーザーがプルダウン メニューからワークチケットの緊急度を選択する場合、ラベルは [緊急度] または [緊急性を選択] になります。 |
type |
|
items[] |
選択可能なアイテムの配列。たとえば、ラジオボタンやチェックボックスの配列などです。最大 100 個のアイテムがサポートされます。 |
onChangeAction |
指定すると、選択が変更されたときにフォームが送信されます。指定しない場合は、フォームを送信する個別のボタンを指定する必要があります。 フォーム入力の操作について詳しくは、フォームデータを受信するをご覧ください。 |
multiSelectMaxSelectedItems |
複数選択メニューの場合、ユーザーが選択できるアイテムの最大数。最小値は 1 アイテムです。指定しない場合のデフォルトは 3 アイテムです。 |
multiSelectMinQueryLength |
複数選択メニューの場合、アプリがクエリする前にユーザーが入力するテキスト文字数がオートコンプリートされ、メニューに候補が表示されます。 指定しない場合、デフォルトで静的データソースの場合は 0 文字、外部データソースの場合は 3 文字になります。 |
共用体フィールド Google Chat アプリで利用できますが、Google Workspace アドオンでは利用できません。 |
|
externalDataSource |
リレーショナル データベースなどの外部データソース。 |
platformDataSource |
Google Workspace のデータソース。 |
PlatformDataSource
複数選択メニューを使用する
ウィジェットの場合、Google Workspace のデータソース。複数選択メニューの項目を入力するために使用します。SelectionInput
Google Chat アプリで利用できますが、Google Workspace アドオンでは利用できません。
フィールド | |
---|---|
共用体フィールド data_source 。データソース。data_source は次のいずれかになります。 |
|
commonDataSource |
Google Workspace 組織内のユーザーなど、すべての Google Workspace アプリケーションで共有されるデータソース。 |
hostAppDataSource |
Google Chat のスペースなど、Google Workspace ホスト アプリケーションに固有のデータソース。 |
CommonDataSource
すべての Google Workspace アプリケーションで共有されるデータソース。
Google Chat アプリで利用できますが、Google Workspace アドオンでは利用できません。
列挙型 | |
---|---|
UNKNOWN |
デフォルト値。使用しないでください。 |
USER |
Google Workspace ユーザー。Google Workspace 組織内のユーザーを表示、選択することのみ可能です。 |
SelectionItem
チェックボックスやスイッチなど、ユーザーが選択入力で選択できる項目。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
フィールド | |
---|---|
text |
ユーザーにアイテムを識別または説明するテキスト。 |
value |
このアイテムに関連付けられた値。クライアントはこれをフォームの入力値として使用する必要があります。 フォーム入力の操作について詳しくは、フォームデータを受信するをご覧ください。 |
selected |
デフォルトでアイテムが選択されるかどうか。選択入力で 1 つの値しか受け入れられない場合(ラジオボタンやプルダウン メニューなど)、このフィールドは 1 つのアイテムにのみ設定します。 |
startIconUri |
複数選択メニューの場合、アイテムの |
bottomText |
複数選択メニューの場合、アイテムの |
SelectionType
ユーザーが選択できるアイテムの形式。使用できる操作の種類は、オプションによって異なります。たとえば、ユーザーは複数のチェックボックスをオンにできるが、プルダウン メニューから選択できるアイテムは 1 つのみです。
各選択入力では、1 種類の選択がサポートされます。たとえば、チェックボックスとスイッチを組み合わせることはできません。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
列挙型 | |
---|---|
CHECK_BOX |
チェックボックスのセット。ユーザーは 1 つ以上のチェックボックスをオンにすることができます。 |
RADIO_BUTTON |
ラジオボタンのセット。ユーザーはラジオボタンを 1 つ選択できます。 |
SWITCH |
スイッチのセット。ユーザーは 1 つ以上のスイッチをオンにできます。 |
DROPDOWN |
プルダウン メニュー。ユーザーはメニューから 1 つのアイテムを選択できます。 |
MULTI_SELECT |
静的データまたは動的データの複数選択メニュー。ユーザーはメニューバーから 1 つ以上のアイテムを選択します。ユーザーは、動的データに値を入力することもできます。たとえば、ユーザーが Google Chat スペースの名前を入力し始めると、ウィジェットが自動的にスペースの候補を表示します。 複数選択メニューの項目にデータを入力するには、次のいずれかのタイプのデータソースを使用します。
複数選択メニューの実装方法の例については、 Google Chat アプリと Google Workspace アドオンでご利用いただけます。Google Workspace アドオンの複数選択はデベロッパー プレビュー版です。 |
SubmitFormResponse
オートコンプリート コンテナの取得以外のフォーム送信に対するレスポンス。カードが実行すべきアクションやアドオン ホストアプリが実行するアクション、カードの状態が変更されたかどうかの情報が含まれています。
Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。次に例を示します。
{
"renderActions": {
"action": {
"notification": {
"text": "Email address is added: salam.heba@example.com"
}
},
"hostAppAction": {
"gmailAction": {
"openCreatedDraftAction": {
"draftId": "msg-a:r-79766936926021702",
"threadServerPermId": "thread-f:15700999851086004"
}
}
}
}
}
フィールド | |
---|---|
renderActions |
カードにアクションの実行を指示する、またはアドオン ホストアプリにアプリ固有のアクションを実行するよう指示する、レンダリング命令のセット。 |
stateChanged |
カードの状態が変更されたかどうか、既存のカードのデータが古くなっているかどうか。 |
schema |
これは、構文チェックのためにマークアップに存在する可能性がある NoOps スキーマ フィールドです。 |
候補
ユーザーが入力できる推奨値。これらの値は、ユーザーがテキスト入力フィールドの中をクリックすると表示されます。ユーザーが入力を始めると、入力内容に応じて推奨値が動的にフィルタされます。
たとえば、プログラミング言語のテキスト入力フィールドには、Java、JavaScript、Python、C++ の候補が表示されます。ユーザーが Jav
の入力を開始すると、候補のリストが Java
と JavaScript
を表示するようにフィルタします。
推奨値は、ユーザーがアプリで理解できる値をユーザーが入力できるようにするのに役立ちます。JavaScript を指す場合、javascript
と java script
を入力するユーザーが存在します。JavaScript
を提案することで、ユーザーによるアプリの操作方法を標準化できます。
指定すると、MULTIPLE_LINE
に設定されていても、TextInput.type
は常に SINGLE_LINE
になります。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
フィールド | |
---|---|
items[] |
テキスト入力フィールドでオートコンプリートの候補に使用される候補のリスト。 |
SuggestionItem
ユーザーがテキスト入力フィールドに入力できる推奨値の 1 つ。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
フィールド | |
---|---|
共用体フィールド
|
|
text |
テキスト入力フィールドへの候補入力の値。これはユーザーが自分自身で入力する内容と同じです。 |
TextInput
ユーザーがテキストを入力できるフィールド。提案と変更時のアクションをサポートします。Google Chat アプリの例については、テキスト入力をご覧ください。
チャットアプリは、フォーム入力イベント中に入力されたテキストの値を受信し、処理できます。フォーム入力の操作について詳しくは、フォームデータを受信するをご覧ください。
未定義のデータや抽象的なデータを収集する必要がある場合は、テキスト入力を使用します。定義済みデータまたは列挙データをユーザーから収集するには、SelectionInput
ウィジェットを使用します。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
フィールド | |
---|---|
name |
フォーム入力イベントでテキスト入力を識別する名前。 フォーム入力の操作について詳しくは、フォームデータを受信するをご覧ください。 |
label |
ユーザー インターフェースのテキスト入力フィールドの上に表示されるテキスト。 ユーザーがアプリに必要な情報を入力するのに役立つテキストを指定します。たとえば、誰かの名前を尋ねているが、その人の姓が特に必要な場合は、
|
hintText |
テキスト入力フィールドの下に表示されるテキスト。ユーザーに特定の値の入力を促します。このテキストは常に表示されます。
|
value |
ユーザーが入力した値。フォーム入力イベントの一部として返されます。 フォーム入力の操作について詳しくは、フォームデータを受信するをご覧ください。 |
type |
ユーザー インターフェースにおけるテキスト入力フィールドの表示。たとえば、フィールドが単一行か複数行かなどです。 |
onChangeAction |
テキスト入力フィールドで変更が発生した場合の処理。たとえば、ユーザーによるフィールドへの追加やテキストの削除などです。 実行できるアクションの例として、カスタム関数を実行する、Google Chat でダイアログを開くなどが挙げられます。 |
initialSuggestions |
ユーザーが入力できる推奨値。これらの値は、ユーザーがテキスト入力フィールドの中をクリックすると表示されます。ユーザーが入力を始めると、入力内容に応じて推奨値が動的にフィルタされます。 たとえば、プログラミング言語のテキスト入力フィールドには、Java、JavaScript、Python、C++ の候補が表示されます。ユーザーが 推奨値は、ユーザーがアプリで理解できる値をユーザーが入力できるようにするのに役立ちます。JavaScript を指す場合、 指定すると、 Google Chat アプリと Google Workspace アドオンでご利用いただけます。 |
autoCompleteAction |
省略可。テキスト入力フィールドから操作を行ったユーザーに候補が表示された場合のアクションを指定します。 指定しない場合、提案は 指定すると、アプリは、カスタム関数の実行など、ここで指定されたアクションを実行します。 Google Workspace アドオンでご利用いただけますが、Google Chat アプリではご利用いただけません。 |
placeholderText |
テキスト入力フィールドが空のときに表示されるテキスト。このテキストを使用して、ユーザーに値の入力を促します。例: Google Chat アプリで利用できますが、Google Workspace アドオンでは利用できません。 |
タイプ
ユーザー インターフェースにおけるテキスト入力フィールドの表示。たとえば、単一行の入力フィールドか複数行の入力フィールドかなどです。initialSuggestions
が指定されている場合、MULTIPLE_LINE
に設定されていても、type
は常に SINGLE_LINE
です。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
列挙型 | |
---|---|
SINGLE_LINE |
テキスト入力フィールドの高さは 1 行に固定されています。 |
MULTIPLE_LINE |
テキスト入力フィールドの高さは複数行に固定されています。 |
TextParagraph
書式設定をサポートするテキストの段落。Google Chat アプリの例については、段落テキストをご覧ください。テキストの書式設定について詳しくは、Google Chat アプリでのテキストの書式設定と Google Workspace アドオンでのテキストの書式設定をご覧ください。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
フィールド | |
---|---|
text |
ウィジェットに表示されるテキスト。 |
ウィジェット
各カードはウィジェットで構成されています。
ウィジェットは、テキスト、画像、ボタンなどのオブジェクト タイプのいずれかを表す複合オブジェクトです。
フィールド | |
---|---|
horizontalAlignment |
ウィジェットを列の左、右、中央に揃えるかどうかを指定します。 |
共用体フィールド data 。ウィジェットに含めることができるアイテムは、次のいずれかのみです。複数のウィジェット フィールドを使用して、さらに多くのアイテムを表示できます。data は次のいずれかになります。 |
|
textParagraph |
段落テキストを表示します。シンプルな HTML 形式のテキストをサポートします。テキストの書式設定について詳しくは、Google Chat アプリでのテキストの書式設定と Google Workspace アドオンでのテキストの書式設定をご覧ください。 たとえば、次の JSON は太字のテキストを作成します。
|
image |
画像を表示します。 たとえば、次の JSON は代替テキストを含む画像を作成します。
|
decoratedText |
装飾されたテキスト アイテムを表示します。 たとえば、次の JSON は、メールアドレスを示す装飾されたテキスト ウィジェットを作成します。
|
buttonList |
ボタンのリスト。 たとえば、次の JSON は 2 つのボタンを作成します。1 つ目は青色のテキストボタン、2 つ目はリンクを開く画像ボタンです。
|
textInput |
ユーザーが入力できるテキスト ボックスを表示します。 たとえば、次の JSON はメールアドレスのテキスト入力を作成します。
別の例として、次の JSON は、静的な候補を使用するプログラミング言語のテキスト入力を作成します。
|
selectionInput |
ユーザーがアイテムを選択できる選択コントロールを表示します。選択コントロールには、チェックボックス、ラジオボタン、スイッチ、プルダウン メニューがあります。 たとえば、次の JSON は、ユーザーがサイズを選択できるプルダウン メニューを作成します。
|
dateTimePicker |
ユーザーが日時を入力できるウィジェットを表示します。 たとえば、次の JSON は、予約をスケジュールする日時選択ツールを作成します。
|
divider |
ウィジェット間に水平線の分割線を表示します。 たとえば、次の JSON は分割線を作成します。
|
grid |
アイテムのコレクションをグリッドに表示します。 グリッドは任意の数の列とアイテムをサポートします。行数は、数値項目の上限を列数で割った値です。2 つの列に 10 個の項目があるグリッドには 5 行あります。11 個の項目と 2 列のグリッドには 6 行あります。 Google Chat アプリと Google Workspace アドオンでご利用いただけます。 たとえば、次の JSON は 1 つのアイテムを含む 2 列のグリッドを作成します。
|
columns |
最大 2 列まで表示されます。 3 つ以上の列を含める、または行を使用する場合は、 たとえば、次の JSON は、それぞれテキスト段落を含む 2 つの列を作成します。
|
HorizontalAlignment
ウィジェットを列の左、右、中央に揃えるかどうかを指定します。
Google Chat アプリで利用できますが、Google Workspace アドオンでは利用できません。
列挙型 | |
---|---|
HORIZONTAL_ALIGNMENT_UNSPECIFIED |
使用しないでください。(指定なし) |
START |
デフォルト値。列の開始位置に合わせてウィジェットを調整します。左から右のレイアウトの場合は、左に揃えます。右から左へのレイアウトの場合は、右に揃えます。 |
CENTER |
ウィジェットを列の中央に揃えます。 |
END |
列の最終位置に合わせてウィジェットを調整します。左から右のレイアウトの場合、ウィジェットを右に揃えます。右から左へのレイアウトでは、ウィジェットを左に揃えます。 |
ImageType
画像の切り抜きに使用する形状。
Google Chat アプリと Google Workspace アドオンでご利用いただけます。
列挙型 | |
---|---|
SQUARE |
デフォルト値。画像に正方形のマスクを適用します。たとえば、4x3 の画像は 3x3 になります。 |
CIRCLE |
円形マスクを画像に適用します。たとえば、4x3 の画像は直径 3 の円になります。 |