부가 작업

부가기능 작업은 위젯 작업을 만들어 사용자가 선택하거나 업데이트할 때 발생하는 작업을 정의합니다. 위젯일 수 있습니다

대부분의 경우 Action 드림 Apps Script 카드 서비스에서 제공하는 객체. 각 Action는 콜백 함수를 생성합니다. 콜백 함수 구현 사용자가 위젯과 상호작용할 때 원하는 단계를 실행할 수 있습니다. 또한 위젯에 Action 연결 적절한 위젯 핸들러 함수 사용 어떤 유형의 상호작용이 트리거되어 Action 콜백을 호출합니다.

Action로 위젯 구성 다음 일반 프로세스를 사용합니다.

1. Action 객체를 만듭니다. 호출되어야 하는 콜백 함수를 실행할 수 있습니다
2. 적절한 위젯 핸들러 함수 호출 Action를 사용하여 위젯에서 객체를 지정합니다.
3. 콜백 함수를 구현하여 필요한 동작을 실행합니다.

를 통해 개인정보처리방침을 정의할 수 있습니다.

참고: Action를 혼동하지 마세요. CardAction가 포함된 객체 객체입니다. CardAction 객체 는 카드 헤더 메뉴 항목이며, Action는 객체는 UI와의 사용자 상호작용에 관한 응답을 정의합니다.

위젯 핸들러 함수

위젯을 특정 Action에 연결하려면 다음 단계를 따르세요. 또는 다른 동작이 있는 경우 핸들러 함수를 사용합니다. 핸들러 함수는 어떤 종류의 상호작용을 (예: 위젯 클릭 또는 텍스트 필드 수정) 있습니다. 핸들러 함수는 또한 UI가 실행하는 단계를 정의합니다. (있는 경우) 작업이 완료된 후

다음 표에는 위젯에 대한 다양한 핸들러 유형과 다음 위젯과 함께 사용할 수 있습니다.

핸들러 함수	트리거 작업	적용 가능한 위젯	설명
setOnChangeAction()	위젯 값이 변경됨	DatePicker DateTimePicker SelectionInput Switch TextInput TimePicker	Action 설정 위젯이 포커스를 잃을 때(예: 예를 들어 사용자가 입력에 텍스트를 입력하고 Enter 키를 누를 때를 예로 들 수 있습니다. 이 핸들러는 자동으로 event 객체를 이 객체가 호출하는 함수에 추가합니다. 이 이벤트 객체에 추가 매개변수 정보를 삽입할 수 있습니다. 추가할 수 있습니다.
setOnClickAction()	사용자가 위젯을 클릭합니다.	CardAction Image ImageButton DecoratedText TextButton	Action 설정 Apps Script 함수를 실행합니다. 이 핸들러는 자동으로 event 객체를 이 객체가 호출하는 함수에 추가합니다. 이 이벤트 객체에 선택적 매개변수 정보를 삽입할 수 있습니다.
setComposeAction()	사용자가 위젯을 클릭합니다.	CardAction Image ImageButton DecoratedText TextButton	Gmail 전용입니다 Action 이를 통해 이메일 초안을 만든 다음 사용자에게 Gmail UI 편지쓰기 창 초안을 새 메시지나 Gmail에서 열려 있는 메일에 답장합니다. 핸들러가 콜백 함수를 호출할 때 event 객체를 콜백 함수에 추가합니다. 자세한 내용은 임시보관 메일 작성 를 참조하세요.
setOnClickOpenLinkAction()	사용자가 위젯을 클릭합니다.	CardAction Image ImageButton DecoratedText TextButton	Action 설정 사용자가 위젯을 클릭할 때 URL이 열립니다. 다음 경우에 이 핸들러를 사용하세요. 가 URL을 구성해야 합니다. 그렇지 않으면 링크가 표시되기 전에 다른 작업이 수행되어야 합니다. 열림 그렇지 않으면 일반적으로 setOpenLink()를 사용하는 것이 더 간단합니다. URL은 새 창에서만 열 수 있습니다. 닫으면 부가기능을 새로고침하는 UI
setOpenLink()	사용자가 위젯을 클릭합니다.	CardAction Image ImageButton DecoratedText TextButton	사용자가 위젯을 클릭하면 URL이 바로 열립니다. 사용 URL을 알고 있고 열기만 하면 되는 경우 핸들러에 전달됩니다. 그렇지 않은 경우 setOnClickOpenLinkAction() URL은 새 창 또는 오버레이에서 열 수 있습니다. 문을 닫으면 UI가 부가기능을 새로고침할 수 있습니다.
setSuggestionsAction()	사용자가 입력에 텍스트를 입력합니다.	TextInput	Action 설정 사용자가 스크립트를 입력할 때 Apps Script 함수를 사용할 수 있습니다. 핸들러는 자동으로 event 객체를 이 객체가 호출하는 함수에 추가합니다. 자세한 내용은 자동 완성 추천 를 참조하세요.

콜백 함수

콜백 함수는 Action 지정할 수도 있습니다 콜백 함수는 Apps Script 함수이므로 다른 스크립트 함수가 할 수 있는 거의 모든 것을 할 수 있습니다.

경고: Apps Script 카드 서비스는 콜백 함수의 실행 시간을 최대 30초로 제한합니다. 만약 이보다 오래 걸리면 부가기능 UI가 적절하게 Action

콜백 함수는 특정 응답 객체를 반환하는 경우가 있습니다. 이러한 응답 유형은 작업 완료 후에 발생해야 하는 추가 작업을 나타냅니다. 새 카드 표시 또는 표시와 같은 콜백 실행이 완료되는 경우 자동 완성 추천 용어를 사용합니다. 콜백 함수가 특정 카드 서비스에서 빌더 클래스를 사용합니다. 그 객체를 생성합니다.

다음 표는 콜백 함수가 특정 액션에 대한 특정 응답 객체를 지정합니다 이러한 작업은 모두 부가기능이 확장하는 특정 호스트 애플리케이션과 관계없이:

시도한 작업	콜백 함수가 반환해야 함
카드 간 이동	ActionResponse
Notification 표시	ActionResponse
setOnClickOpenLinkAction()를 사용하여 링크 열기	ActionResponse
자동 완성 추천 표시	SuggestionResponse
범용 작업 사용	UniversalActionResponse
기타 작업	Nothing

이러한 작업 외에도 각 호스트 애플리케이션에는 해당 호스트에서만 수행할 수 있는 작업 자세한 내용은 다음을 참고하세요. 가이드:

• 캘린더 작업
• 액션 유도
• Gmail 작업
• 편집자 작업

를 통해 개인정보처리방침을 정의할 수 있습니다.

참고: 응답 빌더 클래스를 사용할 때는 다음과 같이 build()를 호출해야 합니다. 응답 객체를 생성합니다. 이렇게 하지 않으면 오류가 발생합니다.

참고: 범용 작업은 프로젝트 매니페스트에 있고 Action가 필요하지 않음 객체를 사용할 수 있지만 그 콜백 함수는 UniversalActionResponse.

작업 이벤트 객체

부가기능이 Action를 트리거하면 UI가 자동으로 JSON 이벤트 객체를 구성하여 인수를 Action 콜백에 전달 함수를 사용하세요. 이 이벤트 객체에는 사용자의 현재 클라이언트측 컨텍스트(예: 모든 상호작용 객체의 현재 값) 위젯을 사용할 수 있습니다.

작업 이벤트 객체에는 확인할 수 있습니다. 동일한 구조는 홈페이지 트리거 홈페이지가 생성되거나 상황별 트리거 애드온 디스플레이를 업데이트합니다.

전체 내용은 이벤트 객체를 참고하세요. 이벤트 객체 구조에 대한 설명입니다.

참고: Gmail 부가기능은 이 이벤트 객체 구조의 간소화된 버전을 사용했습니다. 지금은 지원 중단되었습니다 이전 버전과의 호환성을 위해 모든 원본 Gmail 부가기능 이벤트 객체 필드는 새 이벤트에 계속 포함됩니다. 객체 구조 (이벤트 객체 구조 참고) 그러나 동일한 정보가 일반적인 이벤트 및 Gmail 일정 객체 하위 구조와 같습니다 Gmail 부가기능을 Google Workspace 부가기능의 경우 코드를 조정해야 합니다. 업데이트된 이벤트 객체 필드를 사용하게 됩니다. 결국 원래 Gmail에서 이벤트 객체 필드는 삭제됩니다.