권장사항

부가기능 디자인에 관한 다음 가이드에 따라 사용자의 전반적인 환경을 개선하세요.

일반 권장사항

개발하는 모든 부가기능에 관해 다음 권장사항을 따르는 것이 좋습니다.

시작하기 전에 부가기능 소유권 결정

부가기능은 특정 계정이 소유하거나 공유 드라이브에 있는 Apps Script 프로젝트에 의해 정의됩니다. 부가기능을 코딩하기 전에 프로젝트를 소유해야 하는 계정과 게시자 역할을 하는 계정을 결정해야 합니다. 또한 공동작업자 역할을 할 계정을 결정하고 해당 계정에 스크립트 프로젝트 및 관련 Cloud Platform 프로젝트에 대한 액세스 권한이 있는지 확인합니다.

복제하지 말고 Google Workspace 확장

부가기능은 확장하는 Google Workspace 애플리케이션에 새로운 기능을 제공하거나 복잡한 작업을 자동화하기 위한 것입니다. 단순히 애플리케이션 내에 이미 있는 기능을 복제하거나 워크플로를 크게 개선하지 않는 부가기능은 게시를 위한 부가기능 검토를 통과할 가능성이 낮습니다.

범위를 좁히세요.

범위를 명시적으로 정의할 때는 항상 가능한 최소 허용 범위 집합을 선택하세요. 예를 들어 부가기능에 읽기 액세스 권한만 필요한 경우 https://www.googleapis.com/auth/calendar 범위로 사용자의 캘린더에 대한 전체 액세스 권한을 요청하지 마세요. 읽기 전용 액세스의 경우 https://www.googleapis.com/auth/calendar.readonly 범위를 사용합니다.

라이브러리에 너무 많이 의존하지 마세요

Apps Script 라이브러리를 사용하면 부가기능이 모든 Apps Script 코드가 단일 스크립트 프로젝트 내에 포함된 경우보다 더 느리게 실행될 수 있습니다. Apps Script 라이브러리는 부가기능에서 작동하지만 사용하면 성능이 저하될 수 있습니다. 프로젝트에 불필요한 라이브러리를 포함하지 말고 부가기능의 의존도를 줄이는 방법을 고려하세요.

위에서 설명한 지연 시간은 서버 측 라이브러리로 사용되는 Apps Script 프로젝트에만 적용됩니다. 이러한 지연 시간 없이 jQuery와 같은 클라이언트 측 자바스크립트 라이브러리를 자유롭게 사용할 수 있습니다.

편집자 부가기능 권장사항

다음 권장사항은 편집자 부가기능에만 적용됩니다.}

인터페이스 HTML 및 클라이언트 측 자바스크립트를 고유한 스크립트 파일에 배치합니다.

Apps Script 프로젝트에서 여러 개의 스크립트 파일을 만들 수 있습니다. 부가기능 사이드바 및 대화상자를 전용 스크립트 파일에 정의하는 HTML 및 자바스크립트를 배치하면 복잡한 부가기능을 더 쉽게 관리할 수 있습니다.

다양한 승인 모드에서 철저하게 테스트

부가기능을 테스트할 때 파일과 승인 상태가 다른 구성을 사용해 보세요.