부가기능 디자인 가이드를 따라 사용자의 전반적인 환경을 개선하세요.
일반 권장사항
개발하는 모든 부가기능에 다음 권장사항을 따르는 것이 좋습니다.
시작하기 전에 부가기능 소유권 확인
부가기능은 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와 같은 클라이언트 측 JavaScript 라이브러리는 이러한 지연 시간이 발생하지 않고 자유롭게 사용할 수 있습니다.
편집기 부가기능 권장사항
다음 권장사항은 편집기 부가기능에만 적용됩니다.
인터페이스 HTML 및 클라이언트 측 JavaScript를 자체 스크립트 파일에 배치합니다.
Apps Script 프로젝트에서 여러 스크립트 파일을 만들 수 있습니다. 부가기능 사이드바와 대화상자를 정의하는 HTML 및 JavaScript를 전용 스크립트 파일에 배치하면 복잡한 부가기능을 더 쉽게 관리할 수 있습니다.
다양한 승인 모드에서 철저히 테스트
부가기능을 테스트할 때는 다른 파일과 다른 승인 상태가 있는 구성을 사용해 보세요.