OnClick

• JSON 表現
• OpenLink
  • JSON 表現
• OpenAs
• OnClose
• OverflowMenu
  • JSON 表現
• OverflowMenuItem
  • JSON 表現

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

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

JSON 表現
{ "action": { object (Action) }, "openLink": { object (OpenLink) }, "openDynamicLinkAction": { object (Action) }, "card": { object (Card) }, "overflowMenu": { object (OverflowMenu) } }

フィールド
相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。
action	object (Action) 指定すると、この onClick によってアクションがトリガーされます。
openLink	object (OpenLink) 指定すると、この onClick によってリンクを開くアクションがトリガーされます。
openDynamicLinkAction	object (Action) アドオンは、アクションでリンクを開く必要がある場合に、このアクションをトリガーします。これは、リンクを取得するためにサーバーと通信する必要があるという点で、上記の openLink とは異なります。そのため、ウェブ クライアントは、リンクを開くアクションのレスポンスが返される前に、いくつかの準備作業を行う必要があります。 Google Workspace アドオンで使用可能。Google Chat アプリでは使用不可。
card	object (Card) 指定されている場合、クリック後に新しいカードがカードスタックにプッシュされます。 Google Workspace アドオンで使用可能。Google Chat アプリでは使用不可。
overflowMenu	object (OverflowMenu) 指定すると、この onClick によってオーバーフロー メニューが開きます。
相互に排他的なフィールドの終了。

OpenLink

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

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

JSON 表現
{ "url": string, "openAs": enum (OpenAs), "onClose": enum (OnClose) }

フィールド
url	string 開く URL。HTTP URL は HTTPS に変換されます。
openAs	enum (OpenAs) リンクを開く方法。 Google Workspace アドオンで使用可能。Google Chat アプリでは使用不可。
onClose	enum (OnClose) クライアントがリンクを開いた後にリンクを忘れるか、ウィンドウが閉じるまでリンクを監視するか。 Google Workspace アドオンで使用可能。Google Chat アプリでは使用不可。

OpenAs

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

Google Workspace アドオンで使用可能。Google Chat アプリでは使用不可。

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

OnClose

OnClick アクションによって開かれたリンクが閉じられたときにクライアントが行う処理。

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

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

Google Workspace アドオンで使用可能。Google Chat アプリでは使用不可。

列挙型
NOTHING	デフォルト値。カードは再読み込みされず、何も起こりません。
RELOAD	子ウィンドウが閉じた後にカードを再読み込みします。 OpenAs.OVERLAY と組み合わせて使用すると、子ウィンドウはモーダル ダイアログとして機能し、子ウィンドウが閉じるまで親カードはブロックされます。

OverflowMenu

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

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

JSON 表現
{ "items": [ { object (OverflowMenuItem) } ] }

フィールド
items[]	object (OverflowMenuItem) 必須。メニュー オプションのリスト。

OverflowMenuItem

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

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

JSON 表現
{ "startIcon": { object (Icon) }, "text": string, "onClick": { object (OnClick) }, "disabled": boolean }

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