3-1. 서비스 계정 방식
서비스 계정 방식을 사용할 때만 진행합니다.
단계 1: 서비스 계정과 키
-
구글 클라우드 콘솔 검색 창에 'IAM'을 입력하고 IAM 및 관리자를 클릭합니다.
-
서비스 계정 > 서비스 계정 만들기를 클릭합니다.
-
이름(예:
logpresso)을 입력하고 만들고 닫기를 클릭합니다. -
만든 서비스 계정의 이메일을 클릭해 상세 화면으로 이동합니다.
-
키 > 키 추가 > 새 키 만들기를 클릭합니다.
-
키 유형으로 JSON을 선택하고 만들기를 클릭합니다. 키 파일이 자동으로 다운로드되니 안전한 곳에 보관하세요.
단계 2: 도메인 전체 위임
-
서비스 계정 상세 화면의 세부사항 > 고급 설정에서 클라이언트 ID를 복사하고, GOOGLE WORKSPACE 관리 콘솔 보기를 클릭합니다.
-
관리 콘솔에서 보안 > 액세스 및 데이터 관리 > API 관리로 이동해 도메인 전체 위임 관리를 클릭합니다.
-
새로 추가를 클릭하고 클라이언트 ID와 OAuth 범위를 입력한 뒤 승인을 클릭합니다. OAuth 범위는 1. 기능별 필요 권한 표에서 사용할 기능의 범위만 쉼표로 구분해 입력합니다.
모든 기능을 사용하려면 아래 문자열을 그대로 붙여 넣습니다.
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 이상으로 업그레이드한 뒤에 줄이세요. 업그레이드 전에 줄이면 모든 수집기와 확장 명령어가 멈춥니다.
- 도메인 전체 위임은 서비스 계정이 조직의 모든 사용자 이름으로 등록한 범위에 접근할 수 있게 합니다. 사용하지 않는 기능의 범위는 등록하지 말고, 키 파일을 안전하게 관리하세요.








