부가기능으로 Google Sheets 확장

Google Sheets는 실시간 공동작업과 데이터를 시각화, 처리, 전달하는 강력한 도구를 갖춘 클라우드 기반 스프레드시트 솔루션입니다.

맞춤설정된 워크플로 개선사항을 빌드하고, 타사 시스템과의 연결을 설정하며, Sheets 데이터를 다른 Google Workspace 애플리케이션 (예: Google Slides)과 통합하는 부가기능으로 Sheets를 확장할 수 있습니다.

Google Workspace Marketplace에서 다른 사용자가 빌드한 Sheets 부가기능을 확인할 수 있습니다.

취할 수 있는 조치

Google 스프레드시트를 확장하는 부가기능으로 할 수 있는 몇 가지 작업은 다음과 같습니다.

  • 기본 제공되는 Apps Script 스프레드시트 서비스를 사용하여 Google Sheets 스프레드시트의 데이터를 읽고, 수정하고, 시각화하고, 서식을 지정할 수 있습니다. 이 서비스를 사용하면 조건부 서식 및 데이터 유효성 검사 규칙을 만들고 수정할 수도 있습니다.
  • Apps Script 고급 스프레드시트 서비스를 사용하여 Google Sheets API에 직접 액세스할 수 있습니다.
  • 표준 HTML 및 CSS를 사용하여 맞춤 메뉴를 만들고 여러 맞춤 대화상자 및 사이드바 인터페이스를 정의할 수 있습니다.
  • 부가기능에 커스텀 함수 정의를 포함할 수 있습니다.
  • 특정 트리거 이벤트가 발생할 때 지정된 함수를 실행하는 부가기능 트리거를 사용할 수 있습니다.

Sheets 부가기능은 Apps Script를 사용하여 빌드됩니다. Apps Script를 사용하여 Google 스프레드시트에 액세스하고 관리하는 방법을 자세히 알아보려면 Google 스프레드시트 확장을 참조하세요.

시트 구조

Google 스프레드시트는 하나 이상의 시트로 구성됩니다. 각 시트는 기본적으로 텍스트, 숫자, 링크 또는 기타 값을 저장할 수 있는 셀의 2D 그리드입니다. 하나 이상의 인접한 셀로 구성된 그룹을 범위라고 합니다.

Apps Script 스프레드시트 서비스는 Sheets의 조직 구조를 나타내는 여러 클래스(예: Sheet, Range)를 제공합니다. 이러한 클래스를 사용하여 Sheets 데이터 및 동작을 읽고 수정할 수 있습니다.

트리거

Apps Script 트리거를 사용하면 스프레드시트가 열릴 때 또는 부가기능이 설치될 때와 같이 특정 조건이 충족될 때 스크립트 프로젝트가 지정된 함수를 실행할 수 있습니다.

Sheets 부가기능과 함께 사용할 수 있는 트리거와 사용 시 적용되는 제한사항에 대한 자세한 내용은 부가기능 트리거를 참고하세요.

커스텀 함수

Google 스프레드시트에는 Google 시트 셀 내에서 호출할 수 있는 SUM, AVERAGE 등 다양한 기본 제공 함수가 있습니다. 스프레드시트 부가기능은 이러한 기본 제공 함수를 보완하는 맞춤 함수를 추가로 정의할 수 있습니다. 사용자가 부가기능을 설치하면 부가기능에 포함된 정의된 맞춤 함수는 즉시 사용할 수 있습니다. 부가기능은 맞춤 함수 정의로만 구성될 수 있습니다. 맞춤 함수 정의는 주로 정의가 포함된 부가기능을 게시하여 다른 사용자와 공유됩니다.

부가기능 맞춤 함수 만들기

부가기능 스크립트 프로젝트에 정의된 모든 함수를 맞춤 함수로 사용할 수 있습니다. 함수가 구현되고 부가기능이 설치되면 다른 기본 제공 스프레드시트 함수처럼 맞춤 함수를 호출할 수 있습니다. 시트 셀에서 =, 함수 이름, 필수 매개변수를 차례로 입력합니다. 오류가 없으면 함수에서 반환한 결과가 시트 셀에 배치되고 필요에 따라 인접 셀로 오버플로됩니다.

부가기능에서 맞춤 함수를 만들 때는 다음과 같은 일반 커스텀 함수 가이드라인을 따라야 합니다.

또한 부가기능에 정의된 맞춤 함수에는 몇 가지 특별한 고려사항이 있습니다.

  • 함수 이름을 지정할 때는 부가기능의 이름과 관련된 고유한 이름을 만들어 보세요. 2개 이상의 설치된 부가기능에서 이름이 같은 커스텀 함수를 정의하는 경우 사용자는 그중 하나만 사용할 수 있습니다.
  • 부가기능은 어떤 맞춤 함수를 제공하는지 명확하게 전달해야 합니다. Apps Script가 사용자에게 자동 완성 정보를 제공할 수 있도록 커스텀 함수에 정확한 JSDoc 주석을 제공해야 합니다. 또한 부가기능 자체 또는 부가기능 지원 웹페이지에서 커스텀 함수에 관한 추가 문서를 제공하는 것이 좋습니다.
  • 30초 이내에 완료되지 않는 커스텀 함수는 Internal error executing the custom function 오류와 함께 실패합니다. 맞춤 함수에서 처리하는 처리의 양을 제한하여 우수한 사용자 환경을 구축하세요. 가능한 경우 함수를 최적화합니다.
  • 커스텀 함수는 승인이 필요한 Apps Script 서비스를 사용할 수 없으며, 이를 시도하면 You do not have permission to call X service 오류와 함께 실패합니다. 커스텀 함수에서는 허용되는 서비스만 사용하세요.
  • 시트의 맞춤 함수마다 Apps Script 서버를 별도로 호출합니다. 사용자가 너무 많은 셀에서 커스텀 함수를 사용하려고 하면 함수가 느리게 실행될 수 있습니다. 이 문제를 완화하려면 커스텀 함수를 가능한 한 단순하게 유지합니다. 복잡한 처리나 확장된 처리를 실행해야 하는 함수가 필요하다면 커스텀 함수를 사용하지 말고 메뉴 항목, 대화상자 또는 사이드바 상호작용을 통해 기능을 제공하세요.

Sheets 매크로

매크로를 사용하면 Google Sheets에서 실행한 작업을 기록하고 나중에 단축키를 사용해 반복할 수 있습니다. 시트에서 매크로가 생성되면 해당 시트에 바인드된 Apps Script 프로젝트에 매크로 함수로 추가됩니다. 매크로에 관한 자세한 내용은 Google Sheets 매크로를 참고하세요.

유감스럽게도 Sheets 매크로는 부가기능을 통해 배포할 수 없습니다. 부가기능의 매니페스트에 매크로 정의를 포함하면 부가기능 사용자는 이 정의를 사용할 수 없습니다.