스크립트 프로젝트

스크립트 프로젝트는 간단히 '스크립트'라고 부르는 Google Apps Script의 파일 및 리소스 모음을 나타냅니다. 스크립트 프로젝트에는 코드 파일 (.gs 확장자가 있음) 또는 HTML 파일 (.html 확장자)일 수 있는 스크립트 파일이 하나 이상 있습니다. 또한 HTML 파일에 자바스크립트 및 CSS를 포함할 수 있습니다.

스크립트 편집기에는 항상 하나의 프로젝트만 열려 있습니다. 여러 브라우저 창이나 탭에서 여러 프로젝트를 열 수 있습니다.

프로젝트 생성 및 삭제

이 섹션에서는 독립형 또는 컨테이너에 바인딩된 Apps Script 프로젝트를 만들고 삭제하는 방법을 설명합니다.

독립형 프로젝트 만들기

Apps Script에서 독립형 프로젝트를 만들려면 다음 단계를 따르세요.

  1. script.google.com으로 이동합니다.
  2. 새 프로젝트를 클릭합니다.
  3. 스크립트 편집기에서 제목 없는 프로젝트를 클릭합니다.
  4. 프로젝트 이름을 지정하고 이름 바꾸기를 클릭합니다.

Google Drive에서 독립형 프로젝트 만들기

  1. Google Drive를 엽니다.
  2. 새로 만들기 > 더보기 > Google Apps Script를 클릭합니다.

Google Docs, Sheets, Slides에서 컨테이너 결합 프로젝트 만들기

  1. Docs 문서, Sheets 스프레드시트 또는 Slides 프레젠테이션을 엽니다.
  2. 확장 프로그램 > Google Apps Script를 클릭합니다.
  3. 스크립트 편집기에서 제목 없는 프로젝트를 클릭합니다.
  4. 프로젝트 이름을 지정하고 이름 바꾸기를 클릭합니다.

Google Forms에서 컨테이너 결합 프로젝트 만들기

  1. Google Forms에서 양식을 엽니다.
  2. 더보기 > 스크립트 편집기를 클릭합니다.
  3. 스크립트 편집기에서 제목 없는 프로젝트를 클릭합니다.
  4. 프로젝트 이름을 지정하고 이름 바꾸기를 클릭합니다.

clasp 명령줄 도구를 사용하여 독립형 프로젝트 만들기

clasp는 터미널에서 Apps Script 프로젝트를 만들고, 가져오고, 푸시하고, 배포할 수 있는 명령줄 도구입니다.

자세한 내용은 clasp를 사용한 명령줄 인터페이스 가이드를 참고하세요.

컨테이너에 결합된 프로젝트 삭제

  1. 위의 적절한 방법을 사용하여 컨테이너 결합 프로젝트를 엽니다.
  2. 왼쪽 상단에서 Overview(개요) 를 클릭합니다.
  3. 오른쪽 상단에서 삭제 > 완전삭제를 클릭합니다.

독립형 프로젝트 삭제

  1. script.google.com으로 이동합니다.
  2. 삭제하려는 프로젝트의 오른쪽에서 더보기 > 삭제 > 삭제를 클릭합니다.

프로젝트 내 파일 관리

파일 만들기

  1. Apps Script 프로젝트를 엽니다.
  2. 왼쪽에서 편집기 > 추가 를 클릭합니다.
  3. 만들려는 파일 유형을 선택하고 이름을 지정합니다.

파일 삭제

  1. Apps Script 프로젝트를 엽니다.
  2. 왼쪽에서 편집기 를 클릭합니다.
  3. 삭제하려는 파일 옆에 있는 더보기 > 삭제를 클릭합니다.

Apps Script 프로젝트에서 파일 내보내기

Apps Script에서 코드 파일을 가져오려면 각 파일의 코드를 복사하여 원하는 텍스트 편집기에 붙여넣거나 명령줄에서 clasp를 사용하면 됩니다. clasp를 사용하려면 스크립트 프로젝트 다운로드를 참고하세요.

프로젝트의 시간대 설정

Apps Script 프로젝트의 시간대를 설정할 수 있습니다. 스크립트에서 수행하는 함수는 이 시간대를 사용합니다.

  1. Apps Script 프로젝트를 엽니다.
  2. 왼쪽에서 프로젝트 설정 프로젝트 설정 아이콘을 클릭합니다.
  3. 시간대 섹션에서 사용하려는 시간대를 선택합니다.

특정 함수가 스크립트 프로젝트와 다른 시간대를 사용하도록 하려면 함수에 시간대를 명시적으로 입력합니다. 예를 들어 아래 샘플에서 각 함수는 Google Calendar에서 새 이벤트를 만듭니다. 첫 번째 함수는 프로젝트 시간대로 기본 설정됩니다. 두 번째 함수는 태평양 시간대를 지정하므로 프로젝트 시간대와 상관없이 태평양 표준시로 이벤트가 예약됩니다.

function createEvent(){
// Creates an event in the script project's time zone and logs the ID
var event = CalendarApp.getDefaultCalendar().createEvent('New test event',
   new Date('December 20, 2022 17:00:00'),
   new Date('December 20, 2022 18:00:00'));
console.log('Event ID: ' + event.getId());
}
function createEventPacific(){
// Creates an event with a specified time zone and logs the event ID.
var event = CalendarApp.getDefaultCalendar().createEvent('New sample event',
   new Date('December 20, 2022 17:00:00 PDT'),
   new Date('December 20, 2022 18:00:00 PDT'));
console.log('Event ID: ' + event.getId());
}

여러 Google 계정 관련 문제 해결하기

동시에 여러 Google 계정에 로그인한 경우 부가기능과 웹 앱에 액세스하는 데 문제가 발생할 수 있습니다. Apps Script, 부가기능 또는 웹 앱에서는 멀티 로그인이나 한 번에 여러 Google 계정에 로그인할 수 없습니다.

  • 두 개 이상의 계정에 로그인한 상태에서 Apps Script 편집기를 열면 계속 진행할 계정을 선택하라는 메시지가 표시됩니다.

  • 웹 앱 또는 부가기능을 열 때 멀티 로그인 문제가 발생하면 다음 해결 방법 중 하나를 시도해 보세요.

    • 모든 Google 계정에서 로그아웃하고 액세스하려는 부가기능이나 웹 앱이 있는 계정으로만 로그인합니다.
    • Chrome에서 시크릿 창 또는 이와 동등한 시크릿 브라우징 창을 열고 액세스하려는 부가기능이나 웹 앱이 있는 Google 계정에 로그인합니다.