Google Workspace

다운로드 212
업데이트 2026. 10. 15.

3-1. 서비스 계정 방식

서비스 계정 방식을 사용할 때만 진행합니다.

단계 1: 서비스 계정과 키

  1. 구글 클라우드 콘솔 검색 창에 'IAM'을 입력하고 IAM 및 관리자를 클릭합니다.

    IAM 및 관리자

  2. 서비스 계정 > 서비스 계정 만들기를 클릭합니다.

  3. 이름(예: logpresso)을 입력하고 만들고 닫기를 클릭합니다.

    서비스 계정 생성

  4. 만든 서비스 계정의 이메일을 클릭해 상세 화면으로 이동합니다.

    서비스 계정 상세 이동

  5. 키 > 키 추가 > 새 키 만들기를 클릭합니다.

    새 키 만들기

  6. 키 유형으로 JSON을 선택하고 만들기를 클릭합니다. 키 파일이 자동으로 다운로드되니 안전한 곳에 보관하세요.

    JSON 키 만들기

    키 파일 저장

단계 2: 도메인 전체 위임

  1. 서비스 계정 상세 화면의 세부사항 > 고급 설정에서 클라이언트 ID를 복사하고, GOOGLE WORKSPACE 관리 콘솔 보기를 클릭합니다.

    클라이언트 ID 복사

  2. 관리 콘솔에서 보안 > 액세스 및 데이터 관리 > API 관리로 이동해 도메인 전체 위임 관리를 클릭합니다.

    도메인 전체 위임 관리

  3. 새로 추가를 클릭하고 클라이언트 ID와 OAuth 범위를 입력한 뒤 승인을 클릭합니다. OAuth 범위는 1. 기능별 필요 권한 표에서 사용할 기능의 범위만 쉼표로 구분해 입력합니다.

    새 클라이언트 ID 추가

    모든 기능을 사용하려면 아래 문자열을 그대로 붙여 넣습니다.

    https://www.googleapis.com/auth/admin.reports.audit.readonly,https://www.googleapis.com/auth/drive.apps.readonly,https://www.googleapis.com/auth/apps.alerts,https://www.googleapis.com/auth/admin.directory.domain.readonly,https://www.googleapis.com/auth/admin.directory.user.readonly,https://www.googleapis.com/auth/admin.directory.group.readonly,https://www.googleapis.com/auth/spreadsheets.readonly,https://www.googleapis.com/auth/spreadsheets
    
앱 버전등록할 범위
1.9.2610.0 이상사용할 기능의 범위만 (위 문자열은 전체 기능용 8개)
1.9.2610.0 미만앱이 모든 범위를 한꺼번에 요청하므로 다음 9개 모두. 하나라도 빠지면 모든 기능이 동작하지 않음: admin.reports.audit.readonly, drive.apps.readonly, apps.alerts, admin.directory.domain.readonly, admin.directory.user.readonly, admin.directory.group.readonly, spreadsheets, drive.activity.readonly, contacts.readonly
Caution
  • 도메인 전체 위임은 범위 이름이 정확히 일치해야 합니다. 예를 들어 spreadsheets를 등록해도 spreadsheets.readonly가 등록된 것으로 보지 않습니다.
  • 기존에 등록한 범위를 줄이려면 앱을 1.9.2610.0 이상으로 업그레이드한 뒤에 줄이세요. 업그레이드 전에 줄이면 모든 수집기와 확장 명령어가 멈춥니다.
  • 도메인 전체 위임은 서비스 계정이 조직의 모든 사용자 이름으로 등록한 범위에 접근할 수 있게 합니다. 사용하지 않는 기능의 범위는 등록하지 말고, 키 파일을 안전하게 관리하세요.