권장사항

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

일반 권장사항

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

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

부가기능은 특정 계정이 소유하거나 공유 드라이브에 배치해야 하는 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를 전용 스크립트 파일에 배치하면 복잡한 부가기능을 더 쉽게 관리할 수 있습니다.

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

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