Google Workspace
연결과 권한
Google 카드에서 브라우저 승인으로 계정을 연결하고, 상태를 확인하고, 필요한 scope가 빠졌을 때 권한 다시 동의를 진행하는 현재 앱 흐름입니다.
처음 연결하기
- 1
사이드바에서 연결을 엽니다.
- 2
업무 도구 채널 화면에서 Google 카드를 찾습니다.
- 3
연결하기를 누르면 브라우저로 Google 승인 화면이 열립니다.
- 4
승인을 마치고 앱으로 돌아오면 Semo가 계정 상태를 자동으로 다시 확인합니다.
- 5
연결이 완료되면 카드에 계정 이메일과 현재 사용할 수 있는 서비스가 표시됩니다.
상태값과 기본 버튼
| 상태 | 의미 | 카드의 기본 동작 |
|---|---|---|
| connected | Google 계정과 필요한 권한이 정상 연결된 상태 | 연결만 해제 |
| connecting | 브라우저 승인 결과를 확인하거나 연결을 재시도하는 중 | 지금 확인 |
| disconnected | 계정 기록은 있지만 현재 연결이 꺼진 상태 | 다시 연결 |
| consent_incomplete | 계정은 있지만 필요한 권한이 일부 빠진 상태 | 권한 다시 동의 |
| error | 최근 연결 또는 검증 과정에서 오류가 난 상태 | 다시 연결 |
서비스별 권한 범위
권한이 일부 빠지면 서비스별로 막힙니다
Google 계정이 연결돼 보여도 특정 scope가 빠져 있으면 해당 서비스는 바로 쓸 수 없습니다. 이 경우 카드 상태가 권한 추가 필요로 바뀌고, 권한 다시 동의를 진행해야 합니다.
| 서비스 | 현재 확인하는 권한 범위 | 문서에서 권장하는 설명 |
|---|---|---|
| Gmail | 메일 읽기, 초안 작성, 전송 준비 | 메일 검색, 읽기, 작성, 답장 |
| Calendar | 캘린더 목록, 일정 조회/생성/수정/삭제 | 일정 확인과 관리 |
| Drive | 파일 검색, 읽기, 업로드 | 파일 관리와 텍스트 추출 |
| Docs | Google Docs 문서 생성과 텍스트 추가 | 문서 작성과 본문 이어쓰기 |
| Sheets | Google Sheets 생성과 값 추가 | 행 추가 중심의 시트 업데이트 |
| Tasks | 작업 목록 조회, 생성, 수정, 완료 | 작업 관리 |
여러 계정과 기본 계정
- 1
Google 카드 오른쪽 더보기 메뉴를 엽니다.
- 2
연결된 계정 목록에서 현재 사용할 계정을 확인합니다.
- 3
다른 계정을 선택하면 그 계정이 현재 기본 계정으로 전환됩니다.
- 4
계정 추가를 누르면 새 Google 계정을 같은 방식으로 더 연결할 수 있습니다.
- 여러 계정을 연결해도 Google 카드는 하나로 유지됩니다.
- 현재 선택된 계정이 카드 요약과 기본 발신 계정 기준으로 표시됩니다.
연결만 해제, 다시 연결, 권한 다시 동의
- connected 상태에서는 기본 버튼이 연결만 해제로 바뀌고, 계정 기록은 남긴 채 연결만 끊습니다.
- disconnected 또는 error 상태에서는 기본 버튼이 다시 연결로 바뀌어 같은 계정을 다시 승인할 수 있습니다.
- consent_incomplete 상태에서는 권한 다시 동의 버튼으로 빠진 scope만 다시 승인할 수 있습니다.
- 브라우저 승인 창을 닫은 뒤에도 connecting 상태라면 지금 확인을 눌러 앱에서 다시 상태를 조회할 수 있습니다.