Google Workspace Studio에서 자동화된 플로우를 빌드하고 실행하면 보안 및 데이터 개인 정보 보호가 기본적으로 적용됩니다. Workspace Studio는 최소 권한 ID 모델을 사용합니다. 즉, 자동화된 플로우는 사용자의 전체 Google 계정에 대한 광범위하고 제한 없는 액세스 권한을 갖는 대신 각 개별 작업을 수행하는 데 필요한 최소한의 권한만 사용하여 백그라운드 작업을 실행합니다.
자동화를 안전하게 구성하고 조직의 데이터에 액세스하는 방식을 계속 파악하려면 이 가이드를 사용하여 흐름의 각 단계에 필요한 권한을 확인하세요. 이 페이지에서는 각 흐름 단계 유형과 필수 OAuth (Open Authorization) 범위를 매핑합니다.
OAuth 범위가 스튜디오 사용에 미치는 영향
Workspace Studio를 사용할 때 OAuth 범위는 다음과 같은 방식으로 플로우를 빌드, 실행, 관리하는 방식에 영향을 미칩니다.
- 일회성 승인: Google 서비스 (예: Gmail 또는 Google Drive)와 상호작용하는 단계를 처음 추가하면 Google 로그인 메시지가 표시됩니다. 이렇게 하면 해당 단계의 특정 범위가 승인되어 흐름이 백그라운드에서 독립적으로 실행될 수 있습니다.
- 비동기 백그라운드 실행: 흐름이 사용 설정되면 Google 인프라에서 비동기식으로 실행됩니다. 이 흐름은 사용자가 적극적으로 로그인하지 않은 경우에도 승인한 특정 범위만 사용하여 작업 (예: 캘린더 일정 예약 또는 초안 작성)을 수행합니다.
- 중앙 집중식 관리자 감독: 관리자는 관리 콘솔의 에이전트 액세스 관리 설정을 사용하여 조직 전체에서 활성 상태인 모든 플로우를 확인할 수 있습니다. 특정 흐름을 일시중지하거나 개별 OAuth 범위 (예: Gmail은 활성 상태로 유지하면서 Drive 액세스 권한은 삭제)를 타겟팅하고 제한하여 조직의 데이터를 안전하게 보호할 수 있습니다. 자세히 알아보기
권한 부족 문제 해결
플로우가 실행되지 않고 활동 로그에 '권한이 충분하지 않음' 또는 '문제가 발생했습니다' 오류가 표시되면 다음을 확인하세요.
- 흐름 재승인: 빌더에서 흐름을 열고 변경사항 저장을 클릭한 다음 승인 상자의 메시지에 따라 만료되거나 누락된 OAuth 토큰을 새로고침합니다.
- 컨텍스트 인식 액세스 (CAA) 차단: 조직에서 기기 또는 IP 정책을 엄격하게 시행하는 경우 백그라운드 흐름 실행이 차단될 수 있습니다. 핵심 Workspace Studio 클라이언트 ID가 CAA 제한에서 제외되는지 확인합니다.
플로우 단계 및 필수 OAuth 범위
이 표에는 표준 Workspace Studio 단계와 각 단계가 백그라운드에서 실행되는 데 필요한 OAuth 범위가 요약되어 있습니다.
| 단계 이름 | 구성 및 범위 |
|---|---|
| 스튜디오 AI 단계 | |
| AIP 기본 요소 (Gemini에게 물어보기, Gem에게 물어보기, Gemini로 만들기, Deep Research, 읽지 않은 이메일 요약, 추출, 결정, 요약) | https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/documents https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/cloud_search.query |
| 일반 및 유틸리티 | |
| 정해진 일정에 따라 실행하기 | 해당 사항 없음 |
| 웹훅 전송 | 해당 사항 없음 - 외부 서드 파티 |
| 조건 | 해당 사항 없음 - 내부 로직 |
| 목록 필터링하기 | 해당 사항 없음 - 내부 로직 |
| Gmail | |
| 이메일을 수신할 때 | https://www.googleapis.com/auth/gmail.readonly https://www.googleapis.com/auth/gmail.event_trigger https://www.googleapis.com/auth/workspace.workflows.trigger |
| 이메일로 알림 받기 | https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.readonly |
| 이메일 보내기 | https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly |
| 이메일 초안 작성 | https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.readonly |
| 이메일 전달하기 | https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly |
| 답장 초안 작성 | https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly |
| 이메일에 답장 보내기 | https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly |
| 라벨 추가 또는 삭제 | https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly |
| 읽은 상태 또는 읽지 않은 상태로 표시 | https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly |
| 별표표시 또는 별표표시 삭제 | https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly |
| 보관처리 (또는 삭제) | https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly |
| Google Chat | |
| 새로운 사용자가 스페이스에 참여할 때 | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces |
| 채팅 메시지를 수신할 때 | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces |
| 내가 멘션될 때 | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces |
| 이모티콘 반응이 추가될 때 | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces |
| Chat에서 알림 받기 | https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.memberships.app https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships |
| 채팅 스페이스 보내기 | https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.spaces.create https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces |
| 다른 사용자에게 보내기 | https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.memberships.app https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships |
| 메시지에 답장하기 | https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.memberships.app https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships |
| Google Sheets | |
| 시트가 변경될 때 | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly |
| 행 추가 | https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly |
| 행 업데이트 | https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly |
| 행 데이터 삭제 | https://www.googleapis.com/auth/spreadsheet https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly |
| 시트 내용 가져오기 | https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly |
| Google Docs | |
| Google 문서 만들기 | https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/documents https://www.googleapis.com/auth/drive.readonly |
| 문서에 추가 | https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/documents https://www.googleapis.com/auth/drive.readonly |
| Google Calendar 및 Tasks | |
| 회의 내용 기반 | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/calendar.events.readonly |
| 할 일 만들기 | https://www.googleapis.com/auth/tasks |
| 이벤트 만들기 | https://www.googleapis.com/auth/calendar.events |
| 참석자 추가하기 | https://www.googleapis.com/auth/calendar.events |
| Google Drive | |
| 항목이 폴더에 추가될 때 | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata.readonly |
| 파일이 수정될 때 | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly |
| 폴더의 항목이 수정될 때 | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata.readonly |
| 파일 이동 | https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly |
| 파일 복사 | https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly |
| 첨부파일 저장 | https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly |
| 폴더 만들기 | https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly |
| Google Meet | |
| 회의록 | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.meet.readonly https://www.googleapis.com/auth/meetings.space.created https://www.googleapis.com/auth/calendar.events.readonly https://www.googleapis.com/auth/meetings.space.readonly |
| Google Forms | |
| 양식 응답이 접수될 때 | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/forms.responses.readonly https://www.googleapis.com/auth/forms.body.readonly https://www.googleapis.com/auth/drive.readonly (Forms의 DLP 파일 지원에만 해당) |
| NotebookLM | |
| NotebookLM에 소스 추가 | https://www.googleapis.com/auth/drive.readonly |
| NotebookLM에 물어보기 | https://www.googleapis.com/auth/drive.readonly |