제한사항

부가기능으로 수행할 수 있는 작업에는 몇 가지 제한사항이 있습니다. 이러한 위험을 피하여 사용자의 전반적인 환경을 개선하세요.

일반 제한사항

다음 제한사항은 모든 부가기능에 적용됩니다. 다음과 같이 하지 마세요.

Google Workspace 기능 변경하기

부가기능 프레임워크는 한도를 추가하기 위해서가 아니라 Google Workspace 애플리케이션을 향상하도록 설계되었습니다. 따라서 기존 기능을 변경하거나 Google Workspace 문서 공유 모델을 잠글 수 없습니다.

사용자에게 설치 요금 청구

Google은 부가기능 설치에 대한 비용을 사용자에게 청구하는 방법을 제공하지 않으며 부가기능에는 광고를 포함할 수 없습니다. 하지만 자체 결제 시스템을 출시하거나 기존 결제 데이터베이스를 호출할 수 있습니다. 부가기능은 사용자에게 요금을 청구하는 Google 이외의 서비스에 연결될 수 있습니다.

다수의 이벤트 감지

특정 트리거를 제외하고 부가기능은 사용자가 부가기능 외부에서 수행하는 작업을 알려줄 수 없습니다. 예를 들어 사용자가 호스트 애플리케이션 툴바를 클릭하는 경우 감지할 수 없습니다. 사이드바의 클라이언트 측 코드에서 파일 콘텐츠의 변경사항을 폴링할 수 있지만 항상 약간의 지연이 발생합니다.

Google Workspace 부가기능

다음 제한사항은 Google Workspace 부가기능 및 카드 서비스 사용에만 적용됩니다. 다음과 같이 하지 마세요.

모든 Google Workspace 앱 확장

Google Workspace 부가기능은 Gmail, Calendar, Drive, Docs, Sheets, Slides만 확장할 수 있습니다. 최종적으로 Google Workspace 부가기능은 다른 Google Workspace 애플리케이션을 확장할 수 있게 됩니다.

Drive에서 컨텍스트 트리거

Google Workspace 부가기능은 메시지를 읽거나 쓸 때 Gmail에, 그리고 일정이 열려 있을 때 Calendar에 대한 컨텍스트 트리거만 제공할 수 있습니다. Drive 파일의 컨텍스트 트리거는 아직 지원되지 않습니다. 임시 개발 관행을 참고하세요.

편집기의 문서 컨텍스트

Google Workspace 부가기능은 아직 편집기에서 문서 컨텍스트 사용을 지원하지 않습니다. 즉, SpreadsheetApp.getActiveSpreadsheet()와 같은 메서드를 사용하여 현재 문서를 가져올 수 없습니다. 임시 개발 관행을 참고하세요.

HTML/CSS 또는 클라이언트 측 스크립팅 사용

Google Workspace 부가기능은 카드 기반 인터페이스를 사용해야 합니다. 편집기 부가기능에서 지원하는 HTML/CSS 인터페이스는 사용할 수 없습니다. Google Workspace 부가기능은 위젯 기반 접근 방식을 사용하여 사용자 인터페이스를 빌드합니다. 이렇게 하면 각 플랫폼의 인터페이스를 빌드하지 않고도 부가기능이 데스크톱과 모바일 플랫폼에서 잘 작동합니다.

완벽한 모바일 지원

당분간 Google Workspace 부가기능은 데스크톱 웹 클라이언트에서 작동합니다. Gmail 모바일 앱 내에서도 컨텍스트 트리거 (즉, Gmail 메일 읽기)가 지원됩니다. Gmail, 캘린더, 드라이브 모바일 앱에서는 아직 컨텍스트가 아닌 홈페이지를 사용할 수 없습니다. 모바일 웹브라우저에서는 Google Workspace 부가기능을 사용할 수 없습니다.

Apps Script 트리거 사용하기

Google Workspace 부가기능에서는 Apps Script 단순 트리거를 만들거나 사용할 수 없습니다.

SVG 이미지 사용하기

현재 SVG 이미지는 카드 서비스 카드 및 위젯과 함께 사용할 수 없습니다.

100개 이상의 위젯 보유

성능상의 이유로 카드에 100개 이상의 위젯 또는 100개 이상의 카드 섹션을 추가할 수 없습니다.