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

Class Action

UI 要素内でインタラクティビティを可能にするアクション。アクションはファイル上で直接行われず、 Apps Script コールバック関数を呼び出すオプションのパラメータがあります。

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

var image = CardService.newImage()
    .setOnClickAction(CardService.newAction()
        .setFunctionName("handleImageClick")
        .setParameters({imageSrc: 'carImage'}));

メソッド

メソッド	戻り値の型	概要
`addRequiredWidget(requiredWidget)`	`Action`	このアクションが有効な送信に必要とするウィジェットの名前を追加します。
`setAllWidgetsAreRequired(allWidgetsAreRequired)`	`Action`	このアクションがすべてのウィジェットからの入力を必要とするかどうかを示します。
`setFunctionName(functionName)`	`Action`	呼び出されるコールバック関数の名前を設定します。
`setInteraction(interaction)`	`Action`	ユーザーとのやり取りを設定します。ダイアログを開く場合にのみ必要です。
`setLoadIndicator(loadIndicator)`	`Action`	アクションの進行中に表示される読み込みインジケーターを設定します。
`setParameters(parameters)`	`Action`	カスタムパラメータをコールバック関数に渡すことができます。
`setPersistValues(persistValues)`	`Action`	フォームの値がクライアントの値とサーバーの値のどちらで決定されるのかを示しますアクションのレスポンスの後に、フォームの `Card` が更新されます。

サポート終了のメソッド

メソッド	戻り値の型	概要
`setMethodName(functionName)`	`Action`

詳細なドキュメント

`addRequiredWidget(requiredWidget)`

このアクションが有効な送信に必要とするウィジェットの名前を追加します。もしウィジェットがこのアクションが呼び出されたときにこのリストに値がない場合、フォームの送信は中止されます。

Google Chat アプリでのみ使用できます。Google Workspace アドオンではご利用いただけません。

var textInput = CardService.newTextInput()
    .setFieldName("text_input_1")
    .setTitle("Text input title")

// Creates a footer button that requires an input from the above TextInput Widget.
var action = CardService.newAction()
    .setFunctionName("notificationCallback")
    .addRequiredWidget("text_input_1");
var fixedFooter =
      CardService
          .newFixedFooter()
          .setPrimaryButton(
              CardService
                  .newTextButton()
                  .setText("help")
                  .setOnClickAction(action));

パラメータ

名前	型	説明
`requiredWidget`	`String`	このアクションに必要なウィジェットの名前。

戻る

Action - チェーン用のオブジェクト。

`setAllWidgetsAreRequired(allWidgetsAreRequired)`

このアクションがすべてのウィジェットからの入力を必要とするかどうかを示します。

Google Chat アプリでのみ使用できます。Google Workspace アドオンではご利用いただけません。

// Creates a button with an action that requires inputs from all widgets.
const button = CardService.newTextButton()
    .setText('Create notification')
    .setOnClickAction(
        CardService.newAction()
            .setAllWidgetsAreRequired(true));

パラメータ

名前	型	説明
`allWidgetsAreRequired`	`Boolean`	アクションがすべてのウィジェットからの入力を必要とするかどうか。デフォルトは `false`。

戻る

Action - チェーン用のオブジェクト。

`setFunctionName(functionName)`

呼び出されるコールバック関数の名前を設定します。必須。

パラメータ

名前	型	説明
`functionName`	`String`	関数の名前。含まれているライブラリや `Library.libFunction1` など。

戻る

Action - チェーン用のオブジェクト。

`setInteraction(interaction)`

ユーザーとのやり取りを設定します。ダイアログを開く場合にのみ必要です。指定しない場合、アプリは通常どおりリンクを開く、関数を実行するなど、Action を実行して応答する。

Google Chat アプリでのみ使用できます。Google Workspace アドオンではご利用いただけません。

const action = CardService.newAction()
    .setFunctionName('handleDialog')
    .setInteraction(CardService.Interaction.OPEN_DIALOG);

パラメータ

名前	型	説明
`interaction`	`Interaction`	指定するインタラクション。

戻る

Action - チェーン用のオブジェクト。

`setLoadIndicator(loadIndicator)`

アクションの進行中に表示される読み込みインジケーターを設定します。

パラメータ

名前	型	説明
`loadIndicator`	`LoadIndicator`	表示するインジケーター。

戻る

Action - チェーン用のオブジェクト。

`setParameters(parameters)`

カスタムパラメータをコールバック関数に渡すことができます。省略可。

パラメータ

名前	型	説明
`parameters`	`Object`	キーと値はどちらも文字列である必要があります。

戻る

Action - チェーン用のオブジェクト。

`setPersistValues(persistValues)`

フォームの値がクライアントの値とサーバーの値のどちらで決定されるのかを示しますアクションのレスポンスの後に、フォームの Card が更新されます。true に設定すると、クライアントの値はサーバーレスポンスの後も保持されます。false に設定すると、サーバーのフォームの値は上書きされます。デフォルトは false です。

クライアントの値を保持することで、フォームが予期せず変更されるのを防ぐことができます。ユーザーが編集を行った後にたとえば、変更後にユーザーが TextInput を編集した場合、サーバーが応答するまでの間です。値が保持されている場合は、サーバーの応答が Card を更新した後もユーザーが残っているそれ以外の場合はフォームのユーザーが最初にフォームに送信した値に戻ります。

クライアント値を保持すると、スクリプトでフォームフィールドをクリアしたり、フォームの値をオーバーライドするため、そのタイプの機能では永続性を有効にしないでください。なしイベントには LoadIndicator.SPINNER を使用することをおすすめします。 UI がロックされ、サーバーが応答する前にユーザーが編集できなくなるためです。または LoadIndicator.NONE を使用して、フォーム内のすべての要素に onChange があることを確認できます。できます。

// Creates a button with an action that persists the client's values as the on-click action.
const button = CardService.newTextButton()
    .setText('Create notification')
    .setOnClickAction(
        CardService.newAction()
            .setPersistValues(true)
            .setFunctionName('functionName'));

パラメータ

名前	型	説明
`persistValues`	`Boolean`	値を保持するかどうか。デフォルトは `false` です。

戻る

Action - チェーン用のオブジェクト。

サポート終了のメソッド

`setMethodName(functionName)`

非推奨。setFunctionName(functionName) のレガシーエイリアス。

パラメータ

名前	型	説明
`functionName`	`String`	関数の名前。含まれているライブラリや `Library.libFunction1` など。

戻る

Action - チェーン用のオブジェクト。