부가 작업

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

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

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

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

위젯 핸들러 함수

위젯을 특정 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 함수이므로 다른 스크립트 함수가 할 수 있는 거의 모든 것을 할 수 있습니다.

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

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

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

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

작업 이벤트 객체

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

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

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