다음 용어는 이 문서 전체에서 사용됩니다.
Calendar 회의 부가기능
회의 제공업체가 Google Calendar 일정에서 회의 옵션을 발표할 수 있도록 하는 데 사용되는 특별한 종류의 부가기능입니다. 이러한 부가기능을 사용하려면 부가기능을 연결할 수 있도록 잘 개발된 회의 솔루션이 필요합니다. 이러한 요구사항으로 인해 대부분의 개발자는 Calendar 회의 부가기능을 만들 필요가 없습니다.
자세한 내용은 Calendar 회의 부가기능을 참고하세요. 또한 Calendar 회의 부가기능을 Google Workspace 부가기능으로 변환하는 방법에 대한 자세한 내용은 게시된 부가기능 업그레이드를 참고하세요.
카드
부가기능 UI의 단일 '페이지'입니다. 카드는 다양한 위젯 객체(버튼, 텍스트 필드, 헤더 등)로 구성됩니다.
자세한 내용은 카드를 참고하세요.
카드 기반
사용자 인터페이스가 사이드바에 창으로 표시되거나 모바일의 경우 메뉴를 통해 다른 활동 창에 도달할 때 표시되는 부가기능 부가기능에는 상단에 있는 툴바가 있어 부가기능을 식별하고 카드(본질적으로 부가기능 UI의 '페이지')를 표시합니다.
Google Workspace 부가기능은 카드 기반입니다.
회의 데이터
사용자가 Google Workspace 부가기능 또는 Calendar 회의 부가기능으로 사용 설정된 서드 파티 회의를 만들고 참여하는 데 Google Calendar가 필요한 정보 집합입니다.
자세한 내용은 컨퍼런스 데이터를 참고하세요.
회의 솔루션
Google Workspace 부가기능 또는 Calendar 회의 부가기능을 사용하여 Google Calendar에서 만들 수 있는 서드 파티 회의 표현
자세한 내용은 회의 솔루션을 참고하세요.
컨텍스트
호스트 애플리케이션의 현재 상태입니다. 예를 들어 Gmail에서 현재 열려 있는 메시지, 수정 중인 캘린더 일정, 선택한 Drive 파일이 호스트 애플리케이션의 현재 컨텍스트의 일부입니다. 컨텍스트는 다른 정보와 함께 트리거 함수에 매개변수로 전달되는 이벤트 객체로 수집됩니다.
상황별 트리거
사용자가 특정 컨텍스트(예: Gmail에서 이메일 대화목록을 열 때)에 들어갈 때 실행되는 트리거를 정의하는 방법입니다. 컨텍스트 트리거를 사용하면 부가기능이 컨텍스트와 관련된 UI를 제공할 수 있습니다. 컨텍스트 트리거는 부가기능 스크립트 프로젝트의 매니페스트에 구성되므로 매니페스트 트리거의 한 유형입니다.
편집자 부가기능
Google Docs, Sheets, Forms 또는 Slides의 확장 프로그램만 허용하는 원래 부가기능 유형 편집기 부가기능은 카드 기반이 아니며, 개발자가 원시 HTML 및 CSS에서 UI를 만들어야 합니다. 각 편집기 부가기능은 하나의 호스트 애플리케이션만 확장할 수 있습니다.
자세한 내용은 편집기 부가기능을 참고하세요.
이벤트 객체
홈페이지가 요청될 때, 부가기능이 응답해야 하는 컨텍스트에 진입할 때, 부가기능 인터페이스의 위젯과 사용자 상호작용의 결과로 생성되는 JSON 객체입니다. 생성된 이벤트 객체는 지정된 트리거 함수 또는 콜백 함수에 전달됩니다. 이벤트 객체의 목적은 사용자의 클라이언트 측 환경 정보 (예: 부가기능 인터페이스 위젯에 입력한 정보)를 부가기능의 서버 측 코드로 전달하는 것입니다. 그러면 서버에서 해당 정보를 토대로 작업을 수행하고 적절한 응답을 반환할 수 있습니다.
자세한 내용은 이벤트 객체를 참고하세요.
Gmail 부가기능
Gmail만을 확장하는 부가기능입니다. Gmail 부가기능은 카드 기반입니다. Gmail 부가기능을 만드는 데 사용되는 기능, 동작, 개발 세부정보는 Google Workspace 부가기능을 만드는 데 사용된 세부정보와 동일합니다.
자세한 내용은 Gmail 부가기능을 참고하세요. 또한 Gmail 부가기능을 Google Workspace 부가기능으로 변환하는 방법에 대한 자세한 내용은 게시된 부가기능 업그레이드를 참고하세요.
홈페이지
부가기능의 루트 UI 카드입니다. 홈페이지는 사용자가 부가기능을 열 때 표시되며 부가기능에서 특정 컨텍스트 밖에 있는 콘텐츠를 표시할 수 있도록 합니다(예: 사용자가 Gmail에서 이메일 대화목록을 보고 있지만 열지 않은 경우). 다른 카드와 마찬가지로 부가기능 홈페이지의 모양과 동작을 정의합니다.
자세한 내용은 홈페이지를 참조하세요.
호스트 또는 호스트 애플리케이션
Gmail 또는 Google Calendar와 같은 Google Workspace 부가기능 확장 프로그램인 Google Workspace 애플리케이션
HTML 기반
Apps Script에서 기본 제공하는 카드 서비스 대신 HTML 및 CSS를 사용하여 사용자 인터페이스가 정의된 부가기능입니다. 이전의 편집기 부가기능만 HTML 기반입니다.
링크 미리보기 트리거
링크 미리보기 트리거는 사용자가 Google Docs와 같은 Google 호스트 애플리케이션 내에서 서드 파티 URL 또는 Google 이외의 URL과 상호작용할 때 실행됩니다. 링크 미리보기 트리거를 사용하면 서비스 또는 API에서 미리 볼 URL 패턴을 정의하고 스마트 칩 및 미리보기 카드를 포함한 미리보기 콘텐츠를 구성할 수 있습니다. 링크 미리보기 트리거는 부가기능 스크립트 프로젝트의 매니페스트에 구성되므로 매니페스트 트리거의 한 유형입니다.
자세한 내용은 스마트 칩으로 링크 미리보기를 참고하세요.
매니페스트
Apps Script 프로젝트에 첨부된 JSON 파일입니다. 매니페스트는 스크립트를 올바르게 실행하는 데 필요한 프로젝트 정보를 정의하는 데 사용됩니다. Google Workspace 부가기능의 경우 매니페스트는 부가기능이 확장할 수 있는 호스트를 지정하고 특정 UI 제어 설정을 제공하는 데 사용됩니다.
매니페스트 트리거
홈페이지 트리거 또는 컨텍스트 트리거와 같이 프로젝트의 매니페스트에 정의된 트리거입니다. 매니페스트 트리거는 부가기능 홈페이지가 요청되거나 부가기능이 디스플레이 업데이트가 필요한 컨텍스트로 전환될 때 새 카드를 만들고 표시하는 데 단독으로 사용됩니다.
매니페스트 트리거는 단순 트리거와 같이 내장되어 있지 않고 Apps Script 스크립트 서비스를 사용하여 프로그래매틱 방식으로 생성할 수 없기 때문에(예: 설치 가능한 트리거) Apps Script의 다른 트리거와 구별됩니다.
비문맥 카드
사용자가 특정 컨텍스트 외부에 있을 때 콘텐츠를 표시하는 카드(예: Gmail에서 이메일 대화목록을 보지만 열지 않은 경우) 홈페이지는 일종의 비맥락 카드입니다.
사이드바
호스트 UI 오른쪽에 Google Workspace 부가기능의 UI가 표시되는 섹션입니다. Gmail 및 편집기 부가기능에서도 사이드바를 정의할 수 있습니다.
스마트 칩
스마트 칩은 Google Workspace 애플리케이션 내의 사용자, 파일, 캘린더 일정 또는 기타 항목을 멘션한 것입니다. 사용자가 칩 위로 마우스를 가져가면 파일 또는 링크에 관한 추가 콘텐츠를 미리 볼 수도 있습니다. 예를 들어 사용자가 Google Slides 프레젠테이션의 칩 위로 마우스를 가져가면 슬라이드 스크린샷, 프레젠테이션 소유자, 이전에 프레젠테이션을 본 적이 있는지가 표시됩니다.
스마트 칩을 사용하여 서드 파티 또는 Google 이외의 서비스의 링크를 미리 보도록 부가기능을 구성할 수 있습니다. Google Docs에서 링크 미리보기를 참고하세요.
트리거
Apps Script 프로젝트 또는 부가기능에서 정의한 조건 및 자동 이벤트 응답입니다. 트리거는 연결된 이벤트가 발생할 때 (예: 부가기능이 열릴 때) 실행되고 지정된 Apps Script 함수 (트리거 함수)가 자동으로 실행되도록 합니다. Google Workspace 부가기능의 경우 트리거 함수는 부가기능 UI 중 표시되는 부분을 제어하기 위해 새 카드를 빌드하는 경우가 많습니다. 특정 이벤트 유형에만 트리거를 포함할 수 있습니다.
자세한 내용은 부가기능 트리거를 참조하세요.
함수 트리거
트리거가 실행될 때 이에 대한 응답으로 실행되는 프로젝트의 Apps Script 함수입니다.
위젯
버튼, 텍스트 필드, 체크박스와 같은 UI 요소입니다. 카드는 Apps Script에 내장된 카드 서비스에 의해 정의된 일련의 위젯 객체로 구성됩니다.
자세한 내용은 위젯을 참조하세요.
위젯 핸들러 함수
특정 위젯을 특정 작업 객체에 연결하는 함수입니다. 각 위젯 유형에는 작업에 연결하는 데 사용할 수 있는 일련의 정의된 위젯 핸들러 함수가 있습니다. 위젯 핸더 함수는 결과 작업을 트리거하는 사용자 상호작용의 종류를 정의하며 위젯 상호작용의 중요한 구성요소입니다.
자세한 내용은 위젯 핸들러 함수를 참고하세요.