배포 만들기 및 관리

Apps Script 프로젝트 배포는 웹 앱, 부가기능 또는 API 실행 파일로 사용할 수 있도록 제공되는 스크립트의 버전입니다. 배포를 만들고 관리하여 코드를 반복하고, 변경사항을 추적하고, 사용자가 액세스할 수 있는 정확한 코드 버전을 제어할 수 있습니다.

배포에는 두 가지 유형이 있습니다.

  • 헤드 배포: 항상 현재 프로젝트 코드와 동기화됩니다.
  • 버전이 지정된 배포: 특정 프로젝트 버전에 연결됩니다.

헤드 배포

헤드 배포는 현재 프로젝트 코드입니다. Apps Script 프로젝트를 만들면 해당 프로젝트의 헤드 배포가 자동으로 생성됩니다.

헤드 배포는 항상 가장 최근에 저장된 코드와 동기화됩니다. 예를 들어 버전이 지정된 배포를 만든 후 코드를 수정하면 헤드 배포에 이러한 변경사항이 반영되지만 버전이 지정된 배포는 그대로 유지됩니다.

헤드 배포를 사용하여 코드를 테스트합니다. 공용 용도로 헤드 배포는 사용하지 마세요.

버전이 지정된 배포

버전이 지정된 배포를 통해 특정 버전의 프로젝트 코드를 사용할 수 있습니다. 이렇게 하면 개발자가 코드를 변경하고 개선하는 동안 사용자가 작동하는 버전을 계속 사용할 수 있습니다.

애플리케이션이 공개용으로 게시되는 경우 항상 버전이 지정된 배포를 사용합니다. 버전이 지정된 활성 배포는 한 번에 여러 개 있을 수 있습니다.

중요: 버전이 지정된 배포의 소유권은 이전할 수 없습니다. 스크립트 프로젝트의 소유권을 다른 사람에게 이전해도 프로젝트 내의 기존 버전이 지정된 배포 소유자는 변경되지 않습니다. 관리자가 배포 소유자의 계정을 삭제하면 해당 배포에 스크립트 오류가 발생할 수 있습니다.

버전이 지정된 배포 만들기

Google Workspace 부가기능, 편집자 부가기능, Google Chat 앱 또는 API 실행 파일의 버전을 배포하려면 먼저 Apps Script의 Google Cloud 프로젝트 연결을 기본 프로젝트에서 표준 프로젝트로 전환해야 합니다.

버전이 지정된 배포를 만들려면 다음 단계를 따르세요.

  1. Apps Script 프로젝트를 엽니다.
  2. 오른쪽 상단에서 배포 > 새 배포를 클릭합니다.
  3. 유형 선택 옆에 있는 배포 유형 사용 설정 을 클릭합니다.
  4. 배포할 배포 유형을 선택합니다. Google Workspace 부가기능, 편집자 부가기능, Google Chat 앱의 경우 부가기능을 선택합니다.
  5. 배포에 대한 정보를 입력하고 배포를 클릭합니다.

버전이 지정된 배포 보기

Apps Script 프로젝트의 배포를 보려면 상단에서 배포 > 배포 관리를 클릭합니다.

특정 버전의 코드를 보려면 이전 버전 보기를 참고하세요.

버전이 지정된 배포 수정

버전이 지정된 배포를 수정하여 설명이나 버전을 변경할 수 있습니다. 배포를 편집하려면 다음 단계를 따르세요.

  1. Apps Script 프로젝트를 엽니다.
  2. 배포 > 배포 관리를 클릭합니다.
  3. 변경할 활성 배포를 선택하고 수정 을 클릭합니다.
  4. 변경한 후 배포를 클릭합니다.

    보관처리된 배포를 수정하려면 배포를 다시 배포한 후 이전 단계를 따라야 합니다.

    프로젝트 코드에 대한 변경사항을 배포하려면 새 버전을 만들고 이를 사용하도록 배포를 수정합니다. 새 버전은 해당 배포를 사용하는 모든 사용자가 자동으로 사용합니다.

배포 ID 찾기

모든 배포에는 자동으로 생성되는 연결된 문자열 ID가 있습니다. 이 ID를 찾으려면 다음 단계를 따르세요.

  1. Apps Script 프로젝트를 엽니다.
  2. 오른쪽 상단에서 배포 > 배포 관리를 클릭합니다.
  3. 활성 배포를 선택하여 ID를 찾으세요.

    배포 ID는 활성 배포에만 표시됩니다.

배포 테스트

배포를 테스트하는 방법은 빌드하는 앱 유형에 따라 다릅니다.

Google Workspace 부가기능

Google Workspace 부가기능 배포를 테스트하려면 Google Workspace 부가기능 테스트를 참조하세요.

편집자 부가기능

편집자 부가기능 배포를 테스트하려면 편집자 부가기능 테스트를 참고하세요.

웹 앱

웹 앱 배포를 테스트하려면 웹 앱 배포 테스트를 참조하세요.

Google Chat 앱

채팅 앱 배포를 테스트하려면 먼저 스크립트의 버전이 지정된 배포를 만들어 배포 ID에 액세스해야 합니다.

배포 ID를 받으면 단계에 따라 Google Chat API를 사용 설정합니다. 구성 페이지의 '권한'에서 이메일 주소만 지정하면 앱을 설치하고 테스트할 수 있습니다.

API 실행 파일

API 실행 가능 배포를 테스트하려면 먼저 버전이 지정된 배포를 생성해야 합니다. 배포를 만든 후에는 다음 단계를 따르세요.

  1. Apps Script 프로젝트의 오른쪽 상단에서 배포 > 배포 테스트를 클릭합니다.
  2. '유형 선택' 옆의 배포 유형 사용 설정 > API 실행 파일을 클릭합니다.
  3. URL을 복사하고 사용하여 API 실행 파일 배포를 테스트합니다.

버전이 지정된 배포 보관처리

버전이 지정된 배포는 삭제할 수 없습니다. 대신 보관처리할 수 있습니다.

버전이 지정된 배포를 보관처리하려면 다음 안내를 따르세요.

  1. Apps Script 프로젝트를 엽니다.
  2. 배포 > 배포 관리를 클릭합니다.
  3. 보관처리할 배포를 선택하고 배포 보관 을 클릭합니다.

보관처리된 배포 재배포

  1. Apps Script 프로젝트를 엽니다.
  2. 오른쪽 상단에서 배포 > 배포 관리를 클릭합니다.
  3. 왼쪽의 보관처리됨 아래에서 재배포할 배포를 선택하고 수정 > 배포를 클릭합니다.