부가기능 작업은 위젯 작업을 만들어 사용자가 선택하거나 업데이트할 때 발생하는 작업을 정의합니다. 위젯일 수 있습니다
대부분의 경우
Action
Apps Script 카드 서비스에서 제공하는 객체.
각 Action는
콜백 함수를 생성합니다. 콜백 함수 구현
사용자가 위젯과 상호작용할 때 원하는 단계를 실행할 수 있습니다. 또한
위젯에 Action 연결
적절한 위젯 핸들러 함수 사용
어떤 유형의 상호작용이 트리거되어
Action 콜백을 호출합니다.
Action로 위젯 구성
다음 일반 프로세스를 사용합니다.
Action객체를 만듭니다. 호출되어야 하는 콜백 함수를 실행할 수 있습니다- 적절한 위젯 핸들러 함수 호출
Action를 사용하여 위젯에서 객체를 지정합니다. - 콜백 함수를 구현하여 필요한 동작을 실행합니다.
위젯 핸들러 함수
위젯을 특정 Action에 연결하려면 다음 단계를 따르세요.
또는 다른 동작이 있는 경우
핸들러 함수를 사용합니다. 핸들러 함수는 어떤 종류의 상호작용을
(예: 위젯 클릭 또는 텍스트 필드 수정)
있습니다. 핸들러 함수는 또한 UI가 실행하는 단계를 정의합니다.
작업이 완료된 후
다음 표에는 위젯에 대한 다양한 핸들러 유형과 다음 위젯과 함께 사용할 수 있습니다.
| 핸들러 함수 | 트리거 작업 | 적용 가능한 위젯 | 설명 |
|---|---|---|---|
setOnChangeAction() |
위젯 값이 변경됨 |
DatePickerDateTimePickerSelectionInputSwitchTextInput
TimePicker
|
Action 설정
위젯이 포커스를 잃을 때(예:
예를 들어 사용자가 입력에 텍스트를 입력하고 Enter 키를 누를 때를 예로 들 수 있습니다. 이
핸들러는 자동으로
event 객체를 이 객체가 호출하는 함수에 추가합니다.
이 이벤트 객체에 추가 매개변수 정보를 삽입할 수 있습니다.
추가할 수 있습니다. |
setOnClickAction() |
사용자가 위젯을 클릭합니다. |
CardActionImageImageButtonDecoratedTextTextButton
|
Action 설정
Apps Script 함수를 실행합니다. 이
핸들러는 자동으로
event 객체를 이 객체가 호출하는 함수에 추가합니다.
이 이벤트 객체에 선택적 매개변수 정보를 삽입할 수 있습니다. |
setComposeAction() |
사용자가 위젯을 클릭합니다. |
CardActionImageImageButtonDecoratedTextTextButton
|
Gmail 전용입니다
Action
이를 통해 이메일 초안을 만든 다음 사용자에게
Gmail UI 편지쓰기 창 초안을 새 메시지나
Gmail에서 열려 있는 메일에 답장합니다. 핸들러가
콜백 함수를 호출할 때
event 객체를 콜백 함수에 추가합니다.
자세한 내용은
임시보관 메일 작성
를 참조하세요. |
setOnClickOpenLinkAction() |
사용자가 위젯을 클릭합니다. |
CardActionImageImageButtonDecoratedTextTextButton
|
Action 설정
사용자가 위젯을 클릭할 때 URL이 열립니다. 다음 경우에 이 핸들러를 사용하세요.
가 URL을 구성해야 합니다. 그렇지 않으면 링크가 표시되기 전에 다른 작업이 수행되어야 합니다.
열림 그렇지 않으면 일반적으로 setOpenLink()를 사용하는 것이 더 간단합니다.
URL은 새 창에서만 열 수 있습니다. 닫으면
부가기능을 새로고침하는 UI |
setOpenLink() |
사용자가 위젯을 클릭합니다. |
CardActionImageImageButtonDecoratedTextTextButton
|
사용자가 위젯을 클릭하면 URL이 바로 열립니다. 사용
URL을 알고 있고 열기만 하면 되는 경우 핸들러에 전달됩니다. 그렇지 않은 경우
setOnClickOpenLinkAction()
URL은 새 창 또는 오버레이에서 열 수 있습니다. 문을 닫으면
UI가 부가기능을 새로고침할 수 있습니다. |
setSuggestionsAction() |
사용자가 입력에 텍스트를 입력합니다. |
TextInput
|
Action 설정
사용자가 스크립트를 입력할 때 Apps Script 함수를
사용할 수 있습니다. 핸들러는 자동으로
event 객체를 이 객체가 호출하는 함수에 추가합니다.
자세한 내용은
자동 완성 추천
를 참조하세요. |
콜백 함수
콜백 함수는 Action
지정할 수도 있습니다 콜백 함수는 Apps Script 함수이므로
다른 스크립트 함수가 할 수 있는 거의 모든 것을 할 수 있습니다.
콜백 함수는 특정 응답 객체를 반환하는 경우가 있습니다. 이러한 응답 유형은 작업 완료 후에 발생해야 하는 추가 작업을 나타냅니다. 새 카드 표시 또는 표시와 같은 콜백 실행이 완료되는 경우 자동 완성 추천 용어를 사용합니다. 콜백 함수가 특정 카드 서비스에서 빌더 클래스를 사용합니다. 그 객체를 생성합니다.
다음 표는 콜백 함수가 특정 액션에 대한 특정 응답 객체를 지정합니다 이러한 작업은 모두 부가기능이 확장하는 특정 호스트 애플리케이션과 관계없이:
| 시도한 작업 | 콜백 함수가 반환해야 함 |
|---|---|
| 카드 간 이동 | ActionResponse |
Notification 표시 |
ActionResponse |
setOnClickOpenLinkAction()를 사용하여 링크 열기 |
ActionResponse |
| 자동 완성 추천 표시 | SuggestionResponse |
| 범용 작업 사용 | UniversalActionResponse |
| 기타 작업 | Nothing |
이러한 작업 외에도 각 호스트 애플리케이션에는 해당 호스트에서만 수행할 수 있는 작업 자세한 내용은 다음을 참고하세요. 가이드:
작업 이벤트 객체
부가기능이 Action를 트리거하면
UI가 자동으로 JSON 이벤트 객체를 구성하여
인수를 Action 콜백에 전달
함수를 사용하세요. 이 이벤트 객체에는 사용자의 현재
클라이언트측 컨텍스트(예: 모든 상호작용 객체의 현재 값)
위젯을 사용할 수 있습니다.
작업 이벤트 객체에는 확인할 수 있습니다. 동일한 구조는 홈페이지 트리거 홈페이지가 생성되거나 상황별 트리거 애드온 디스플레이를 업데이트합니다.
전체 내용은 이벤트 객체를 참고하세요. 이벤트 객체 구조에 대한 설명입니다.