가이드

Gmail OAuth2 API 인증 설정 가이드

작성일 2026.03.20 | 수정일 2026.03.20

Gmail OAuth2 API 인증 설정 가이드

Gmail API를 통해 이메일을 읽고, 보내고, 라벨을 관리하는 등 Gmail의 모든 기능을 프로그래밍 방식으로 사용할 수 있습니다.

사전 준비

API 활성화

  1. Google Cloud Console에 로그인합니다.

  2. API 및 서비스 메뉴에서 라이브러리로 이동합니다.

  3. Gmail API를 검색하여 사용 설정을 클릭합니다.

필요 권한

이 인증은 아래 권한을 자동으로 요청합니다:

권한

설명

https://www.googleapis.com/auth/gmail.labels

라벨 관리

https://www.googleapis.com/auth/gmail.addons.current.action.compose

애드온 작성

https://www.googleapis.com/auth/gmail.addons.current.message.action

애드온 메시지 작업

https://mail.google.com/

전체 메일 접근 (읽기, 쓰기, 삭제)

https://www.googleapis.com/auth/gmail.modify

메일 읽기 및 쓰기 (삭제 제외)

https://www.googleapis.com/auth/gmail.compose

메일 작성 및 전송

https://mail.google.com/ 권한은 Gmail의 전체 접근 권한을 포함하는 민감한 권한입니다. OAuth 동의 화면에서 이 권한을 사용하려면 Google의 앱 검증이 필요할 수 있습니다.

워크플로우 인증 정보 입력

Gmail OAuth2 인증은 Google OAuth2 API를 기반으로 합니다. 권한은 자동으로 설정되므로 별도 입력이 필요하지 않습니다.

인증 연결 절차

  1. 워크플로우에서 Gmail 노드를 추가합니다.

  2. 인증 정보에서 Gmail OAuth2 API를 선택합니다.

  3. 연결 버튼을 클릭하면 Google 로그인 화면이 나타납니다.

  4. Google 계정으로 로그인하고 Gmail 접근 권한을 허용합니다.

  5. 인증이 완료되면 워크플로우에서 이메일을 읽고 보낼 수 있습니다.

참고 링크