승인 범위

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

사용자는 데이터에 액세스하거나 사용자를 대신하여 조치를 취하는 스크립트 프로젝트를 승인해야 합니다. 사용자가 처음으로 승인이 필요한 스크립트를 처음 실행하면 UI에서 승인 흐름을 시작하라는 메시지를 표시합니다.

이 흐름이 진행되는 동안 UI는 사용자에게 스크립트에서 원하는 권한을 알려줍니다. 예를 들어 스크립트가 사용자의 이메일 메시지를 읽거나 캘린더에 일정을 만들 수 있는 권한을 요청할 수 있습니다. 스크립트 프로젝트는 이러한 개별 권한을 OAuth 범위로 정의합니다.

대부분의 스크립트에서 Apps Script는 필요한 범위를 자동으로 감지합니다. 언제든지 스크립트에서 사용하는 범위를 확인할 수 있습니다. URL 문자열을 사용하여 매니페스트에서 범위를 명시적으로 설정할 수도 있습니다. 게시된 애플리케이션은 항상 가장 좁은 범위를 사용해야 하므로 부가기능과 같은 특정 애플리케이션에 범위를 명시적으로 설정해야 하는 경우가 있습니다.

승인 흐름 중에 Apps Script는 사용자에게 필요한 범위에 대한 설명을 사용자에게 표시합니다. 예를 들어 스크립트에 스프레드시트에 대한 읽기 전용 액세스 권한이 필요한 경우 매니페스트의 범위는 https://www.googleapis.com/auth/spreadsheets.readonly일 수 있습니다. 승인 흐름이 진행되는 동안 이 범위의 스크립트가 사용자에게 이 애플리케이션의 'Google 스프레드시트 보기'를 허용하도록 요청합니다.

일부 범위에는 다른 범위가 포함됩니다. 예를 들어 범위가 승인된 경우 https://www.googleapis.com/auth/spreadsheets는 스프레드시트에 대한 읽기 및 쓰기 액세스를 허용합니다.

범위 보기

다음을 수행하면 스크립트 프로젝트에 현재 필요한 범위를 확인할 수 있습니다.

  1. 스크립트 프로젝트를 엽니다.
  2. 왼쪽에서 개요 를 클릭합니다.
  3. 프로젝트 OAuth 범위에서 범위를 확인합니다.

명시적 범위 설정

Apps Script는 코드에서 코드를 요구하는 함수 호출을 찾기 위해 코드에 필요한 범위를 자동으로 결정합니다. 대부분의 스크립트에서는 이 기능으로 충분하고 시간이 절약되지만 게시된 부가기능 및 웹 앱에서는 범위를 더 직접 제어해야 합니다.

Apps Script에서 프로젝트에 매우 허용적인 범위를 자동으로 할당하는 경우도 있습니다. 이 경우 스크립트가 사용자에게 필요한 것보다 더 많은 것을 요청하는 것은 좋지 않습니다. 게시된 스크립트의 경우, 광범위한 범위를 스크립트의 요구사항을 포괄하는 더 제한된 집합으로 대체해야 합니다.

매니페스트 파일을 수정하여 스크립트 프로젝트에서 사용하는 범위를 명시적으로 설정할 수 있습니다. 매니페스트 필드 oauthScopes는 프로젝트에서 사용하는 모든 범위의 배열입니다. 프로젝트 범위를 설정하려면 다음을 수행합니다.

  1. 스크립트 프로젝트를 엽니다.
  2. 왼쪽에서 프로젝트 설정 을 클릭합니다.
  3. 편집기에 'appsscript.json' 매니페스트 파일 표시 체크박스를 선택합니다.
  4. 왼쪽에서 편집기 를 클릭합니다.
  5. 왼쪽에서 appsscript.json 파일을 클릭합니다.
  6. oauthScopes라는 최상위 필드를 찾습니다. 이 태그가 없으면 추가할 수 있습니다.
  7. oauthScopes 필드는 문자열 배열을 지정합니다. 프로젝트에서 사용하는 범위를 설정하려면 이 배열의 콘텐츠를 사용하려는 범위로 바꿉니다. 예를 들면
          {
            ...
            "oauthScopes": [
              "https://www.googleapis.com/auth/spreadsheets.readonly",
              "https://www.googleapis.com/auth/userinfo.email"
            ],
           ...
          }
    
    입니다.
  8. 상단에서 저장 을 클릭합니다.

OAuth 확인

특정 OAuth 범위는 Google 사용자 데이터에 대한 액세스를 허용하므로 민감합니다. 스크립트 프로젝트가 사용자 데이터에 대한 액세스를 허용하는 범위를 사용하는 경우 프로젝트를 OAuth 클라이언트 인증을 거쳐야 웹 앱 또는 부가기능으로 공개적으로 게시할 수 있습니다. 자세한 내용은 다음 가이드를 참조하세요.

제한된 범위

특정 범위는 민감한 범위 외에도 제한됨으로 분류되며 사용자 데이터를 보호하는 데 도움이 되는 추가 규칙이 적용됩니다. 하나 이상의 제한된 범위를 사용하는 부가기능이나 웹 앱을 게시하려는 경우 앱을 게시하려면 지정된 모든 제한사항을 준수해야 합니다.

게시하기 전에 제한된 범위의 전체 목록을 검토하세요. 앱에서 이러한 API를 사용하는 경우 게시하기 전에 특정 API 범위에 관한 추가 요구사항을 준수해야 합니다.