부가기능으로 Google Sheets 확장하기

Google Sheets는 실시간 공동작업을 지원하고 데이터를 시각화, 처리, 소통하는 강력한 도구를 제공하는 클라우드 기반의 스프레드시트 솔루션입니다.

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

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

취할 수 있는 조치

Sheets를 확장하는 부가기능으로 수행할 수 있는 작업은 다음과 같습니다.

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

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

시트 구조

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

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

트리거

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

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

커스텀 함수

Sheets에는 Sheets 셀 내에서 호출할 수 있는 기본 제공 함수 가 SUM 및 AVERAGE와 같이 여러 개 있습니다. Sheets 부가기능은 이러한 기본 제공 함수를 보완하기 위해 추가 커스텀 함수를 정의할 수 있습니다. 사용자가 부가기능을 설치하면 부가기능에 포함된 정의된 커스텀 함수를 즉시 사용할 수 있습니다. 부가기능은 커스텀 함수 정의로만 구성될 수 있습니다. 커스텀 함수 정의는 정의가 포함된 부가기능을 게시하여 다른 사용자와 공유됩니다.

부가기능 커스텀 함수 만들기

부가기능 스크립트 프로젝트에 정의된 함수는 커스텀 함수로 사용할 수 있습니다. 함수가 구현되고 부가기능이 설치되면 다른 기본 제공 Sheets 함수와 마찬가지로 커스텀 함수를 호출할 수 있습니다. 시트 셀에서 =을 입력한 후 함수 이름과 필요한 매개변수를 입력합니다. 오류가 없으면 함수에서 반환된 결과가 Sheets 셀에 배치되고 필요한 경우 인접한 셀로 오버플로됩니다.

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

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

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

Sheets 매크로

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

안타깝게도 Sheets 매크로는 부가기능과 함께 배포할 수 없습니다. 부가기능의 매니페스트에 매크로 정의를 포함하면 해당 부가기능의 사용자가 사용할 수 없습니다.