Google Cloud 프로젝트

모든 Apps Script 프로젝트는 Google Cloud를 사용하여 승인, 고급 서비스, 기타 세부정보를 관리합니다. 이러한 설정을 구성하고 관리하기 위해 모든 Apps Script 프로젝트에는 연결된 Google Cloud 프로젝트가 있습니다. 스크립트 프로젝트는 Apps Script에서 자동으로 생성하는 기본 프로젝트나 사용자가 직접 만든 표준 프로젝트를 사용할 수 있습니다. 일반적으로 기본 프로젝트는 일상적인 스크립트나 간단한 스크립트에 적합하지만 복잡하거나 상업적인 품질이거나 게시를 위한 애플리케이션에는 표준 프로젝트를 사용해야 합니다.

언제든지 기본 프로젝트에서 표준 프로젝트로 전환할 수 있지만 기본 프로젝트를 사용하도록 다시 전환할 수는 없습니다. 개발 초기에 스크립트가 사용하는 Google Cloud 프로젝트를 선택하는 것이 가장 좋습니다. 나중에 전환하면 사용자가 재승인해야 하는 등의 문제가 발생할 수 있습니다.

기본 Google Cloud 프로젝트

Apps Script 프로젝트를 만들면 Apps Script는 백그라운드에서 작동하는 기본 Google Cloud 프로젝트를 만듭니다.

  • 대부분의 스크립트에서 이 기본 프로젝트를 확인하거나 조정할 필요가 없습니다. Apps Script는 Google Cloud와의 필수 상호작용을 처리합니다. 예를 들어 Apps Script 편집기에서 고급 서비스를 활성화하면 스크립트 프로젝트를 저장할 때 Apps Script가 기본 Google Cloud 프로젝트에서 고급 서비스를 활성화합니다.
  • 일부 스크립트의 경우 Google Cloud Console과 상호작용해야 합니다. 이러한 경우 스크립트는 표준 Google Cloud 프로젝트를 사용해야 합니다. 예를 들어 Google Cloud Console에서 Google Cloud 로그를 보려면 스크립트에서 표준 프로젝트를 사용해야 합니다.

기본 Google Cloud 프로젝트 보기 또는 업데이트

대부분의 사용자는 Google Cloud Console에서 기본 프로젝트를 직접 찾거나 보거나 수정할 수 없습니다. 상위 Google Cloud 폴더에 resourcemanager.projects.list 권한이 있는 관리자 및 도메인 사용자는 기본 프로젝트를 보고 구성할 수 있습니다.

  • Google Workspace 고객의 경우 기본 프로젝트는 Cloud 리소스 계층 구조의 Organization root > system-gsuite > apps-script 폴더에 속합니다. 이 폴더를 삭제하지 마세요. 그러면 스크립트에서 기본 프로젝트를 만들 수 없으며 제대로 실행되지 않습니다.
  • Google Workspace 고객이 아닌 경우 기본 프로젝트는 리소스 계층 구조에서 상위가 됩니다.

기본 Google Cloud 프로젝트 삭제

관리자는 표준 Google Cloud 프로젝트와 마찬가지로 기본 Google Cloud 프로젝트를 삭제할 수 있습니다. Apps Script Google Cloud 프로젝트 삭제를 참고하세요.

관리자가 아니라면 기본 프로젝트를 삭제할 수 없습니다. 그러나 다음과 같은 경우 Apps Script가 기본 프로젝트를 삭제합니다.

  • 스크립트 프로젝트를 삭제하거나 표준 프로젝트를 사용하도록 전환하면 Apps Script는 스크립트에 첨부된 기본 프로젝트와 함께 포함된 설정 또는 정보를 삭제합니다.
  • 스크립트가 180일 이상 실행되지 않으면 Apps Script가 연결된 기본 프로젝트를 삭제합니다. Apps Script가 기본 프로젝트를 삭제한 후 스크립트를 실행하면 Apps Script에서 스크립트에 대한 프로젝트를 만듭니다.

표준 Google Cloud 프로젝트

프로젝트를 수동으로 구성해야 하는 경우가 아니라면 기본 Google Cloud 프로젝트가 대부분의 스크립트 프로젝트에 가장 적합합니다. 이러한 상황에서는 표준 프로젝트를 사용하도록 스크립트 프로젝트를 전환해야 합니다.

다음 섹션에서는 Apps Script에 표준 프로젝트가 필요한 시기, 이러한 프로젝트의 속성, 일반적인 작업을 설명합니다. 표준 프로젝트에서만 아래 작업을 수행할 수 있습니다.

Apps Script에 표준 Google Cloud 프로젝트가 필요한 경우

다음과 같은 상황에서는 표준 프로젝트를 사용해야 합니다.

표준 Google Cloud 프로젝트 속성

표준 프로젝트에는 다음과 같은 속성이 있습니다.

  • Google Cloud Console에서 바로 프로젝트의 모든 Google Cloud 설정에 액세스할 수 있습니다. 이를 통해 API를 활성화하고, 승인 사용자 인증 정보를 조정하고, 기타 세부정보를 구성할 수 있습니다.
  • 스크립트 프로젝트를 삭제하거나 다른 표준 프로젝트를 사용하도록 전환하는 경우 원래의 표준 프로젝트는 그대로 유지되며 재사용할 수 있습니다.
  • 스크립트 프로젝트에서 고급 서비스를 활성화할 때는 표준 프로젝트에서 해당 API를 수동으로 활성화해야 합니다.
  • 여러 스크립트 프로젝트 및 기타 앱이 동일한 표준 프로젝트를 공유할 수 있습니다. 스크립트 프로젝트를 Google Workspace Marketplace부가기능으로 게시하려면 자체 표준 프로젝트가 있어야 합니다. 게시된 앱은 Google Cloud 프로젝트를 다른 앱과 공유할 수 없습니다.
  • Apps Script API의 scripts.run 메서드를 사용하여 다른 앱의 스크립트 프로젝트에서 함수를 실행하려면 스크립트 프로젝트와 호출 애플리케이션이 동일한 표준 프로젝트를 공유해야 합니다.
  • Apps Script에서 사용자에게 표준 프로젝트를 사용하는 스크립트를 승인하도록 요청하면 Google Cloud 프로젝트 이름이 스크립트 프로젝트 이름이 아닌 스크립트를 식별하는 데 사용됩니다. 따라서 적절한 Google Cloud 프로젝트 이름을 설정해야 합니다.

표준 Google Cloud 프로젝트에 액세스

스크립트 프로젝트에 연결된 표준 프로젝트에 액세스하려면 다음 단계를 따르세요.

새 편집기

  1. Apps Script 프로젝트를 엽니다.
  2. 왼쪽에서 프로젝트 설정 을 클릭합니다.
  3. Google Cloud Platform (GCP) 프로젝트에서 프로젝트 번호를 클릭합니다.

기존 편집기

  1. Apps Script 편집기에서 스크립트를 엽니다.
  2. 리소스 > Cloud Platform 프로젝트를 선택합니다.
  3. 대화상자가 열리면 GCP 프로젝트 이름을 참조하는 상단 링크를 클릭합니다.

Google Cloud Console 리소스 관리 페이지에서 직접 표준 프로젝트를 찾을 수도 있습니다.

표준 Google Cloud 프로젝트에서 API 활성화

Apps Script 애플리케이션은 다른 Google API에 액세스해야 하는 경우가 많습니다. 이렇게 하려면 해당 Google Cloud 프로젝트에서 API를 활성화해야 합니다. 다음 단계에 따라 API를 활성화합니다.

  1. Google Cloud 프로젝트를 엽니다.
  2. 메뉴 > API 및 서비스를 클릭합니다.
  3. API 및 서비스 사용 설정을 클릭합니다.
  4. 검색창에 활성화할 API를 입력하고 Enter 키를 누릅니다.
  5. 검색결과에서 API를 클릭한 후 사용 설정을 클릭하여 이 Google Cloud 프로젝트의 API를 활성화합니다.

Google API 또는 Google Cloud의 서비스 약관에 동의하라는 메시지가 표시될 수 있습니다. 동의하기 전에 서비스 약관을 주의 깊게 검토하세요.

애플리케이션에 따라 API 및 서비스 대시보드에서 API를 선택하여 구성해야 할 수도 있습니다.

표준 Google Cloud 프로젝트의 ID 및 번호 확인

모든 Google Cloud 프로젝트에는 프로젝트 이름, 프로젝트 ID, 프로젝트 번호가 있습니다. 서비스를 구성하거나 다른 작업을 완료하려면 이러한 식별자가 있어야 하는 경우도 있습니다.

표준 프로젝트의 ID와 번호를 확인하려면 다음 단계를 따르세요.

  1. Google Cloud 프로젝트를 엽니다.
  2. 오른쪽 상단에서 더보기 > 프로젝트 설정을 클릭합니다.
  3. 표시되는 설정 패널에서 프로젝트 이름, 프로젝트 ID, 프로젝트 번호를 확인합니다. 프로젝트 번호는 숫자로만 구성되며 프로젝트 ID는 영숫자입니다. 승인 메시지가 표시되는 동안 사용자에게 표시되는 프로젝트 이름을 수정할 수 있습니다.

Google Cloud Console에서 Google Cloud 로그 및 오류 보고서 보기

스크립트 프로젝트에 Cloud Logging 또는 Error Reporting을 사용하는 경우 Google Cloud Console에서 다음을 실행하여 이러한 로그 및 보고서를 볼 수 있습니다.

  1. Google Cloud 프로젝트를 엽니다.
  2. 메뉴 를 클릭합니다.
  3. 작업 섹션까지 아래로 스크롤하고 로깅 > 로그 탐색기를 클릭합니다.
  4. 오류 보고서를 보려면 작업 섹션까지 아래로 스크롤하고 Error Reporting을 클릭합니다. 오류 보고를 설정하라는 메시지가 표시되면 스크립트 프로젝트에서 아직 예외를 로깅하지 않았음을 의미합니다.

OAuth가 필요한 서비스를 사용하는 경우 Google에서 사용자에게 서비스를 승인하라는 메시지를 표시합니다. OAuth 동의 화면 설정을 사용하면 애플리케이션 이름 및 서비스 약관 URL과 같은 Google이 사용자에게 제공하는 일부 정보를 설정할 수 있습니다.

기본 Google Cloud 프로젝트는 Apps Script 프로젝트 세부정보에서 자동으로 동의 화면을 생성하며, 이 설정을 조정할 수 없습니다. 표준 Google Cloud 프로젝트를 사용하면 이 정보를 맞춤설정할 수 있습니다. 다음 단계에 따라 스크립트의 동의 화면을 구성할 수 있습니다.

  1. Google Cloud 프로젝트를 엽니다.
  2. 메뉴 > API 서비스 사용자 인증 정보를 클릭합니다.
  3. 동의 화면 구성을 클릭합니다.
  4. 동의 화면 워크플로의 각 섹션을 작성합니다.
  5. 워크플로의 각 단계에서 변경사항을 기록하려면 저장하고 계속하기를 클릭합니다.

OAuth 사용자 인증 정보 만들기

Apps Script는 일반적으로 스크립트에서 사용하는 서비스에 OAuth를 설정합니다. 일부 애플리케이션의 경우 추가 OAuth 사용자 인증 정보 (클라이언트 ID 및 클라이언트 보안 비밀번호)를 만들어야 합니다. 이 작업은 표준 프로젝트에서만 수행할 수 있습니다.

스크립트 프로젝트의 클라이언트 ID와 클라이언트 보안 비밀번호를 만들려면 다음 단계를 따르세요.

  1. Google Cloud 프로젝트를 엽니다.
  2. 메뉴 > API 서비스 사용자 인증 정보를 클릭합니다.
  3. 사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 클릭합니다.
  4. 애플리케이션 유형 아래에서 애플리케이션 유형을 선택하고 필요에 따라 결과 양식을 작성합니다. 완료하면 만들기를 클릭합니다.
  5. 대화상자가 나타나면 JSON 다운로드를 클릭합니다. 이 파일을 사용하여 OAuth를 구성할 수 있습니다.

표준 Google Cloud 프로젝트에 소유자 추가하기

표준 프로젝트에 소유자 또는 다른 역할을 추가할 수 있습니다. 프로젝트에서 공동작업하면 팀원이 항상 스크립트 프로젝트의 Google Cloud 설정에 액세스할 수 있습니다.

다음을 수행하여 추가 소유자 또는 다른 역할을 표준 프로젝트에 추가할 수 있습니다. 다음과 같이 변경하려면 프로젝트에 대한 수정 권한이 있어야 합니다.

  1. 공동작업자를 정하세요. Google 그룹을 만들거나 기존 Google 그룹을 사용하는 것이 좋습니다. 또한 공동작업자 목록에서 도메인을 지정하여 해당 도메인의 모든 사용자를 포함할 수도 있습니다.
  2. 스크립트의 Google Cloud 프로젝트를 엽니다.
  3. 메뉴 > IAM &admin > IAM을 클릭합니다.
  4. 상단에서 추가를 클릭합니다.
  5. 화면에 표시된 안내에 따라 하나 이상의 새 구성원과 해당 역할을 Google Cloud 프로젝트에 추가합니다. 개별 이메일, Google 그룹스 또는 도메인을 새 구성원으로 추가할 수 있습니다.
  6. 저장을 클릭합니다.

여러 스크립트를 하나의 Google Cloud 프로젝트로 그룹화

여러 Apps Script 프로젝트가 동일한 표준 Google Cloud 프로젝트를 공유하도록 할 수 있습니다. 이를 위해 표준 프로젝트를 만든 후 각 스크립트 프로젝트를 전환하여 사용합니다. 기본 프로젝트로는 이 작업을 할 수 없습니다.

다른 표준 Google Cloud 프로젝트로 전환

스크립트 프로젝트가 다른 표준 Google Cloud 프로젝트를 사용하도록 전환할 수 있습니다. 스크립트에 Google Cloud 프로젝트의 수동 구성이 필요한 경우 표준 프로젝트로 전환해야 합니다. 표준 프로젝트를 사용해야 하는 경우에 대한 자세한 내용은 표준 Google Cloud 프로젝트를 참조하세요.

스크립트의 기존 Google Cloud 프로젝트를 다른 Google Cloud 프로젝트로 전환하려면 다음 단계를 따르세요.

새 편집기

  1. 적합한 Google Cloud 프로젝트가 없다면 프로젝트 만들기 안내에 따라 프로젝트를 만듭니다. 기억하기 쉬운 프로젝트 이름을 설정하여 Google Cloud Console 리소스 관리 페이지에서 찾을 수 있도록 합니다. Apps Script에서는 사용자에게 스크립트 승인을 요청할 때 이 이름을 사용합니다.
  2. 기존 프로젝트를 사용하려면 Google Cloud Console 리소스 관리 페이지를 열고 사용할 기존 프로젝트를 찾습니다. 프로젝트에 대한 resourcemanager.projects.update 권한이 있어야 합니다. Apps Script에서 자동으로 생성된 프로젝트는 사용할 수 없습니다.
  3. Google Cloud 프로젝트의 프로젝트 번호를 결정합니다.
  4. 교체할 Google Cloud 프로젝트가 있는 스크립트를 엽니다.
  5. 왼쪽에서 프로젝트 설정 을 클릭합니다.
  6. Google Cloud Platform (GCP) 프로젝트에서 프로젝트 변경을 클릭합니다.
  7. 새 프로젝트 번호를 입력하고 프로젝트 설정을 클릭합니다.

기존 편집기

  1. 적합한 GCP 프로젝트가 없는 경우 프로젝트 만들기 안내에 따라 새 프로젝트를 만듭니다. 그렇지 않은 경우 Google Cloud Console 리소스 관리 페이지를 열고 사용할 기존 GCP 프로젝트를 찾습니다. GCP 프로젝트에 대한 수정 권한이 있어야 하며 Google Cloud Console에서 설정을 볼 수 있어야 합니다. 새 프로젝트는 Apps Script에서 자동으로 생성된 프로젝트가 될 수 없습니다.
  2. 기억하기 쉬운 GCP 프로젝트 이름을 설정하여 Google Cloud Console 리소스 관리 페이지에서 쉽게 찾을 수 있도록 합니다. 이 이름은 Apps Script에서 사용자에게 승인을 요청할 때 스크립트를 식별하는 데에도 사용됩니다.
  3. GCP 프로젝트의 프로젝트 번호를 결정합니다.
  4. Apps Script 편집기에서 GCP 프로젝트를 교체할 스크립트를 엽니다.
  5. 리소스 &Cloud Platform 프로젝트를 클릭합니다.
  6. 프로젝트 변경 섹션에서 복사한 프로젝트 번호를 텍스트 필드에 붙여넣은 후 프로젝트 설정을 클릭합니다.
  7. Cloud Platform 프로젝트 변경이 미치는 영향을 설명하는 경고 화면 알림을 주의 깊게 읽은 후 확인을 클릭합니다.

Google Cloud 프로젝트 및 공유 드라이브

공유 드라이브(이전 명칭: 팀 드라이브)에서는 Drive 사용자 그룹이 Apps Script 프로젝트 및 Drive 문서에서 공동작업할 수 있는 공유 공간을 제공합니다. 공유 드라이브는 팀과 함께 스크립트, 부가기능, 웹 앱을 개발할 때 유용하지만 이전 기본 Google Cloud 프로젝트로 수행할 수 있는 작업에는 몇 가지 제한사항이 있습니다.

다음 제한사항 목록은 Google Cloud 프로젝트가 공유 드라이브와 상호작용하는 방법을 설명합니다.

  • 스크립트 프로젝트가 표준 프로젝트를 사용하는 경우 스크립트 프로젝트가 공유 드라이브에 있을 때는 추가 제한이 없습니다.
  • 스크립트 프로젝트에서 2019년 4월 8일 이후에 생성된 기본 프로젝트를 사용하는 경우, 스크립트 프로젝트가 공유 드라이브에 있으면 추가 제한이 없습니다.
  • 스크립트 프로젝트에서 2019년 4월 8일 이전에 생성된 기본 프로젝트를 사용하는 경우 스크립트 프로젝트가 공유 드라이브에 있는 동안 다음 제한사항이 적용됩니다.
    1. Apps Script UI 또는 Google Cloud Console을 사용하여 기본 프로젝트에 액세스할 수 없습니다. 이러한 제한으로 인해 프로젝트에 직접 액세스해야 하는 작업은 수행되지 않습니다.
    2. 고급 서비스를 활성화할 수 없습니다. 고급 서비스를 활성화하려면 표준 프로젝트로 전환하세요.
    3. 기존 Apps Script 프로젝트를 공유 드라이브로 이동하면 Google은 기본 Google Cloud 프로젝트에 대한 액세스를 제한합니다. 이전하기 전에 액세스 권한이 있었다면 기본 프로젝트에 계속 액세스할 수 있습니다. 예를 들어 내 드라이브 폴더에 스크립트를 만들고 공유 드라이브로 이동한 경우에도 스크립트의 Google Cloud 프로젝트에 액세스할 수 있습니다. 공유 드라이브의 공동작업자는 액세스하지 못할 수 있습니다.
    4. 스크립트는 공유 드라이브로 이동하기 전의 Google Cloud 프로젝트 이름을 유지합니다. 공유 드라이브에서 프로젝트 이름을 변경해도 스크립트를 승인하는 사용자는 승인 대화상자에 이전 이름을 계속 볼 수 있습니다.

이전 스크립트에 대한 위의 제한을 방지하려면 표준 프로젝트로 전환하세요.

Apps Script Google Cloud 프로젝트 목록 가져오기

조직의 Apps Script 프로젝트 폴더에 대한 resourcemanager.projects.list 권한이 있는 경우, 폴더 내에서 모든 표준 및 기본 Apps Script Google Cloud 프로젝트를 볼 수 있습니다.

  1. Google Cloud Console 리소스 관리 페이지를 엽니다.
  2. Apps Script 폴더에서 ID를 복사합니다.
  3. 필터 > 상위 ID를 클릭하고 Apps Script 폴더 ID를 붙여넣습니다.

Apps Script Google Cloud 프로젝트 삭제

Apps Script Google Cloud 프로젝트를 삭제하려면 Apps Script Google Cloud 프로젝트 목록 가져오기 아래의 단계에 따라 삭제할 프로젝트를 선택하고 삭제를 클릭합니다.

gcloud을 사용하여 Apps Script 프로젝트를 삭제하려면 다음 명령어를 사용합니다.

gcloud projects list --filter='parent.id=APPS_SCRIPT_FOLDER_ID'
gcloud projects delete PROJECT_ID

Google Cloud 프로젝트 삭제에 대한 자세한 내용은 프로젝트 종료(삭제)를 참조하세요.