코딩 수준: 중급
시간: 30분
프로젝트 유형: Google Workspace 부가기능
목표
- 솔루션의 기능을 이해합니다.
- 솔루션 내에서 Apps Script 서비스가 하는 작업을 이해합니다.
- 환경을 설정합니다.
- 스크립트를 설정합니다.
- 스크립트를 실행합니다.
이 솔루션 정보
한 스프레드시트에서 다른 스프레드시트로 Google Sheets 매크로를 수동으로 복사하면 시간이 오래 걸리고 오류가 발생하기 쉽습니다. 이 Google Workspace 부가기능은 스크립트 프로젝트를 자동으로 복사하여 사용자가 지정한 스프레드시트에 첨부합니다. 이 솔루션은 Sheets 매크로에 중점을 두지만, 이를 사용하여 컨테이너에 결합된 스크립트를 복사하고 공유할 수 있습니다.
사용 방법
이 스크립트는 원본 스프레드시트에 결합된 Apps Script 프로젝트를 복사하고 사용자가 지정한 스프레드시트에 결합된 중복된 Apps Script 프로젝트를 만듭니다.
Apps Script 서비스
이 솔루션은 다음 서비스를 사용합니다.
- URL Fetch 서비스–Apps Script API에 연결하여 소스 프로젝트를 복사하고 사본을 만듭니다.
- 스크립트 서비스: 두 번째 승인 메시지가 표시되지 않도록 Apps Script API를 승인합니다.
- 스프레드시트 서비스: 대상 스프레드시트를 열어 복사된 Apps Script 프로젝트를 추가합니다.
- 카드 서비스: 부가기능의 사용자 인터페이스를 만듭니다.
기본 요건
이 샘플을 사용하려면 다음과 같은 기본 요건이 필요합니다.
- Google 계정 (Google Workspace 계정은 관리자 승인이 필요할 수 있음)
인터넷에 액세스할 수 있는 웹브라우저
Apps Script 대시보드 설정에서 사용 설정된 Google Apps Script API
환경 설정하기
Google Cloud 콘솔에서 Cloud 프로젝트 열기
이 샘플에 사용할 Cloud 프로젝트가 아직 열려 있지 않으면 엽니다.
- Google Cloud 콘솔에서 프로젝트 선택 페이지로 이동합니다.
- 사용할 Google Cloud 프로젝트를 선택합니다. 또는 프로젝트 만들기를 클릭하고 화면에 표시된 안내를 따릅니다. Google Cloud 프로젝트를 만드는 경우 프로젝트에 결제를 사용 설정해야 할 수도 있습니다.
Google Apps Script API 사용 설정
이 빠른 시작에서는 Google Apps Script API를 사용합니다.
Google API를 사용하려면 먼저 Google Cloud 프로젝트에서 사용 설정해야 합니다. 단일 Google Cloud 프로젝트에서 하나 이상의 API를 사용 설정할 수 있습니다.클라우드 프로젝트에서 Google Apps Script API를 사용 설정합니다.
OAuth 동의 화면 구성
Google Workspace 부가기능을 사용하려면 동의 화면 구성이 필요합니다. 부가기능의 OAuth 동의 화면을 구성하면 Google에서 사용자에게 표시하는 내용이 정의됩니다.
- Google Cloud 콘솔에서 메뉴 > API 및 서비스 > OAuth 동의 화면으로 이동합니다.
- 사용자 유형에서 내부를 선택한 다음 만들기를 클릭합니다.
- 앱 등록 양식을 작성한 다음 저장하고 계속하기를 클릭합니다.
지금은 범위 추가를 건너뛰고 저장 후 계속을 클릭해도 됩니다. 앞으로 Google Workspace 조직 외부에서 사용할 앱을 만들 때는 사용자 유형을 외부로 변경한 후 앱에 필요한 승인 범위를 추가해야 합니다.
- 앱 등록 요약을 검토합니다. 변경하려면 수정을 클릭합니다. 앱 등록이 확인되면 대시보드로 돌아가기를 클릭합니다.
스크립트 설정
Apps Script 프로젝트 만들기
- 다음 버튼을 클릭하여 매크로 공유 Apps Script 프로젝트를 엽니다.
프로젝트 열기 - 개요 를 클릭합니다.
- 개요 페이지에서 사본 만들기 를 클릭합니다.
Cloud 프로젝트 번호 복사
- Google Cloud 콘솔에서 메뉴 > IAM 및 관리자 > 설정으로 이동합니다.
- 프로젝트 번호 필드에서 값을 복사합니다.
Apps Script 프로젝트의 클라우드 프로젝트 설정
- 복사된 Apps Script 프로젝트에서 프로젝트 설정 을 클릭합니다.
- Google Cloud Platform(GCP) 프로젝트에서 프로젝트 변경을 클릭합니다.
- GCP 프로젝트 번호에 Google Cloud 프로젝트 번호를 붙여넣습니다.
- 프로젝트 설정을 클릭합니다.
테스트 배포 설치
- 복사된 Apps Script 프로젝트에서 편집기 를 클릭합니다.
UI.gs
파일을 열고 Run을 클릭합니다. 메시지가 표시되면 스크립트를 승인합니다.- 배포 > 배포 테스트를 클릭합니다.
- 설치 > 완료를 클릭합니다.
매크로 스크립트 및 스프레드시트 정보 가져오기
- 매크로가 있고 수정 권한이 있는 스프레드시트 스프레드시트를 엽니다. 샘플 스프레드시트를 사용하려면 샘플 매크로 스프레드시트의 사본을 만드세요.
- 확장 프로그램 > Apps Script를 클릭합니다.
- Apps Script 프로젝트에서 프로젝트 설정 을 클릭합니다.
- 스크립트 ID 아래에서 복사를 클릭합니다.
- 이후 단계에서 사용할 수 있도록 스크립트 ID를 따로 설정합니다.
- 매크로를 추가할 스프레드시트를 열거나 새 스프레드시트를 만듭니다. 스프레드시트를 편집할 수 있는 권한이 있어야 합니다.
- 스프레드시트 URL을 복사하고 이후 단계에서 사용할 수 있도록 따로 설정합니다.
스크립트 실행
대시보드 설정에서 Google Apps Script API를 사용 설정해야 합니다. 스크립트를 실행하려면 다음 섹션의 단계를 따르세요.
매크로를 복사합니다.
- 스프레드시트의 오른쪽 사이드바에서 매크로 공유 부가기능 을 엽니다.
- 소스 매크로에 스크립트 ID를 붙여넣습니다.
- 대상 스프레드시트 아래에 스프레드시트 URL을 붙여넣습니다.
- 매크로 공유를 클릭합니다.
- 액세스 승인을 클릭하고 부가기능을 승인합니다.
- 2~4단계를 반복합니다.
복사한 매크로 열기
- 매크로를 복사한 스프레드시트를 엽니다.
- 확장 프로그램 > Apps Script를 클릭합니다.
- 복사된 Apps Script 프로젝트가 표시되지 않으면 대시보드 설정에서 Google Apps Script API가 사용 설정되어 있는지 확인하고 매크로 복사에 나열된 단계를 반복합니다.
코드 검토
이 솔루션의 Apps Script 코드를 검토하려면 아래의 소스 코드 보기를 클릭하세요.
소스 코드 보기
Code.gs
UI.gs
appsscript.json
기여자
이 샘플은 Google Developer Expert의 도움을 받아 Google에서 관리합니다.