For the complete documentation index, see llms.txt. This page is also available as Markdown.

Gmail 접근 권한 설정

Gmail 접근 권한 설정은 Gmail 연동이 되지 않을 때 구글 관리 콘솔에서 앱 액세스· 도메인 위임 권한을 추가해 연동 문제를 해결하는 방법을 안내합니다.

개요

Gmail 접근 권한 설정은 Gmail 연동이 되지 않을 때 구글 관리 콘솔에서 필요한 접근 권한을 추가해 연동 문제를 해결하는 방법입니다. 상황에 따라 아래 세 가지 방법 중 하나를 사용합니다.


1. 안전하지 않음 앱으로 이동 (개별 계정)

구글 로그인 중 "안전하지 않은 앱" 경고가 나오면 이동을 선택해 진행합니다.

구글 로그인 중 안전하지 않은 앱 경고 화면에서 이동을 선택하는 화면
안전하지 않음 앱 이동

개별 계정이 아니라 조직 전체에 권한을 주려면 아래 2번을 참고하세요.


2. API 관리 > 앱 액세스 제어 추가 (조직 전체)

구글 어드민 앱 액세스 제어 관리에서 새 앱 구성을 추가하는 화면
앱 액세스 제어 추가
  • 새 앱 구성에서 Round Workflow 앱의 클라이언트를 아래 값으로 검색해 추가합니다.

    • 검색: 320456075498-cdnbm7vghm77bi8rkcgj56jsq6ha86u4

새 앱 구성에서 Round Workflow 클라이언트를 검색해 추가하는 화면
Round Workflow 앱 추가
  • 검토 완료까지 진행한 뒤 다시 Gmail 연동을 진행하면 정해진 권한대로 연동됩니다.


3. 도메인 위임 설정 (선택)

개별 OAuth 설정을 한다면 도메인 전체 위임 설정은 하지 않아도 됩니다.

도메인 위임은 Google Workspace 기능으로, 모든 직원을 대신해 OAuth 액세스 권한을 부여해 직원이 개별적으로 권한을 부여할 필요가 없게 합니다.

  • 도메인 위임을 방문해 새 앱 구성 드롭다운을 열고 새 앱 추가를 클릭합니다.

  • 새 클라이언트 추가에 아래 정보를 입력합니다.

    • 클라이언트 ID: 320456075498-cdnbm7vghm77bi8rkcgj56jsq6ha86u4.apps.googleusercontent.com

    • OAuth 범위(이메일 읽기·발송 권한): https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.send

  • 이후 다시 Gmail 연동을 하면 권한 오류 없이 연동됩니다.


자주 묻는 질문

앱 액세스 제어와 도메인 위임 중 무엇을 해야 하나요?

조직 전체에 권한을 주려면 2번(앱 액세스 제어)을 진행합니다. 도메인 위임(3번)은 선택 사항이며, 개별 OAuth 설정을 이미 했다면 도메인 위임은 하지 않아도 됩니다.

구글 로그인 중 "안전하지 않은 앱" 경고가 떠요.

개별 계정이라면 경고 화면에서 이동을 선택해 계속 진행하면 됩니다. 조직 전체에 권한을 주려면 이 방법 대신 2번(앱 액세스 제어)을 진행하세요.

앱 액세스 제어에는 어떤 앱을 추가하나요?

구글 어드민 앱 액세스 제어 관리에서 Round Workflow 앱을 추가합니다. 새 앱 구성에서 클라이언트를 320456075498-cdnbm7vghm77bi8rkcgj56jsq6ha86u4 값으로 검색해 추가한 뒤, 검토를 완료하고 다시 Gmail 연동을 진행하면 됩니다.

마지막 업데이트