Action

양식이 제출될 때의 동작을 설명하는 작업입니다. 예를 들어 Apps Script 스크립트를 호출하여 양식을 처리할 수 있습니다. 작업이 트리거되면 양식 값이 서버로 전송됩니다.

Google Chat 앱 및 Google Workspace 부가기능에 사용할 수 있습니다.

JSON 표현 
{
  "function": string,
  "parameters": [
    {
      object (ActionParameter)
    }
  ],
  "loadIndicator": enum (LoadIndicator),
  "persistValues": boolean,
  "interaction": enum (Interaction),
  "requiredWidgets": [
    string
  ],
  "allWidgetsAreRequired": boolean
}
필드
function

string

포함하는 요소가 클릭되거나 활성화될 때 호출할 맞춤 함수입니다.

사용 예시는 양식 데이터 읽기를 참고하세요.
parameters[]

object (ActionParameter)

작업 매개변수 목록입니다.
loadIndicator

enum (LoadIndicator)

작업을 호출하는 동안 작업에 표시되는 로딩 표시기를 지정합니다.
persistValues

boolean

작업 후 양식 값이 유지되는지 여부를 나타냅니다. 기본값은 false입니다.

true인 경우 작업이 트리거된 후에도 양식 값이 유지됩니다. 작업이 처리되는 동안 사용자가 변경할 수 있도록 하려면 LoadIndicator를 NONE로 설정합니다. Chat 앱의 카드 메시지의 경우 작업의 ResponseType를 UPDATE_MESSAGE로 설정하고 작업이 포함된 카드의 동일한 cardId를 사용해야 합니다.

false인 경우 작업이 트리거되면 양식 값이 삭제됩니다. 작업이 처리되는 동안 사용자가 변경하지 못하도록 하려면 LoadIndicator를 SPINNER로 설정합니다.
interaction

enum (Interaction)

선택사항입니다. 대화상자를 열 때 필요합니다.

사용자가 카드 메시지의 버튼을 클릭하는 등 사용자와의 상호작용에 대한 응답으로 수행할 작업입니다.

지정하지 않으면 앱은 링크 열기나 함수 실행과 같은 action을 정상적으로 실행하여 응답합니다.

interaction를 지정하면 앱이 특별한 대화형 방식으로 응답할 수 있습니다. 예를 들어 interaction를 OPEN_DIALOG로 설정하면 앱에서 대화상자를 열 수 있습니다. 지정하면 로드 표시기가 표시되지 않습니다. 부가기능에 지정된 경우 전체 카드가 삭제되고 클라이언트에 아무것도 표시되지 않습니다.

Google Chat 앱에서 사용할 수 있으며 Google Workspace 부가기능에서는 사용할 수 없습니다.
requiredWidgets[]

string

선택사항입니다. 이 작업에서 유효한 제출을 위해 필요한 위젯의 이름으로 이 목록을 채웁니다.

이 작업이 호출될 때 여기에 나열된 위젯에 값이 없으면 양식 제출이 취소됩니다.

Google Chat 앱 및 Google Workspace 부가기능에 사용할 수 있습니다.
allWidgetsAreRequired

boolean

선택사항입니다. true인 경우 이 작업에 모든 위젯이 필요한 것으로 간주됩니다.

Google Chat 앱 및 Google Workspace 부가기능에 사용할 수 있습니다.

ActionParameter

작업 메서드가 호출될 때 제공할 문자열 매개변수 목록입니다. 예를 들어 지금 다시 알림, 하루 동안 다시 알림, 다음 주에 다시 알림이라는 세 가지 다시 알림 버튼을 생각해 보세요. action method = snooze()를 사용하여 문자열 매개변수 목록에 다시 알림 유형과 다시 알림 시간을 전달할 수 있습니다.

자세한 내용은 CommonEventObject을 참조하세요.

Google Chat 앱 및 Google Workspace 부가기능에 사용할 수 있습니다.

JSON 표현 
{
  "key": string,
  "value": string
}
필드
key

string

작업 스크립트의 파라미터 이름입니다.
value

string

매개변수의 값입니다.

LoadIndicator

작업을 호출하는 동안 작업에 표시되는 로딩 표시기를 지정합니다.

Google Chat 앱 및 Google Workspace 부가기능에 사용할 수 있습니다.

열거형
SPINNER 콘텐츠가 로드 중임을 나타내는 스피너를 표시합니다.
NONE 아무것도 표시되지 않습니다.

상호작용

선택사항입니다. 대화상자를 열 때 필요합니다.

사용자가 카드 메시지의 버튼을 클릭하는 등 사용자와의 상호작용에 대한 응답으로 수행할 작업입니다.

지정하지 않으면 앱은 링크 열기나 함수 실행과 같은 action을 정상적으로 실행하여 응답합니다.

interaction를 지정하면 앱이 특별한 대화형 방식으로 응답할 수 있습니다. 예를 들어 interaction를 OPEN_DIALOG로 설정하면 앱에서 대화상자를 열 수 있습니다.

지정하면 로드 표시기가 표시되지 않습니다. 부가기능에 지정된 경우 전체 카드가 삭제되고 클라이언트에 아무것도 표시되지 않습니다.

Google Chat 앱에서 사용할 수 있으며 Google Workspace 부가기능에서는 사용할 수 없습니다.

열거형
INTERACTION_UNSPECIFIED 기본값 action가 정상적으로 실행됩니다.
OPEN_DIALOG

Chat 앱이 사용자와 상호작용하는 데 사용하는 창이 있는 카드 기반 인터페이스인 대화상자를 엽니다.

카드 메시지의 버튼 클릭에 대한 응답으로 Chat 앱에서만 지원됩니다. 부가기능에 지정된 경우 전체 카드가 삭제되고 클라이언트에 아무것도 표시되지 않습니다.

Google Chat 앱에서 사용할 수 있으며 Google Workspace 부가기능에서는 사용할 수 없습니다.