권장사항

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

일반 권장사항

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

시작하기 전에 부가기능 소유권 확인

부가기능은 Apps Script 프로젝트에 의해 정의되며, 이 프로젝트는 특정 계정이 소유하거나 공유 드라이브에 배치되어야 합니다. 부가기능을 코딩하기 전에 프로젝트를 소유할 계정과 게시자로 작동할 계정을 결정합니다. 또한 공동작업자로 참여할 계정을 결정하고 이러한 계정이 스크립트 프로젝트 및 연결된 Google Cloud 프로젝트에 액세스할 수 있는지 확인합니다.

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를 전용 스크립트 파일에 배치하면 복잡한 부가기능을 더 쉽게 관리할 수 있습니다.

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

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