구글 클라우드 플랫폼(GCP) 연동 가이드

[💡] GCP 가입부터 OAuth 2.0 인증 설정, n8n Credential 등록까지 한 번에 안내합니다. 이 가이드를 따라하면 Gmail, Google Sheets, Calendar, Drive 등 구글 서비스를 n8n 워크플로에서 자유롭게 사용할 수 있게 되거든요.

n8n에서 Gmail, Google Sheets, Google Calendar, Google Drive 같은 구글 서비스를 사용하려면, 먼저 구글 클라우드 플랫폼(Google Cloud Platform, 이하 GCP)에서 인증 설정을 해야 합니다. 처음 들으면 복잡하게 느껴질 수 있지만, 이 가이드를 따라 한 번만 설정하면 모든 구글 서비스를 n8n에서 자유롭게 활용할 수 있습니다.

이 부록은 다음 내용을 다룹니다.

• GCP 계정 가입 및 프로젝트 생성
• 필요한 API 활성화
• OAuth 2.0 인증 설정
• n8n에서 구글 인증 정보 등록

순서	완료할 항목	비고
1	GCP 가입하기	Gmail 계정으로 콘솔 접속
2	프로젝트 생성하기	my-n8n-automation 등 이름 자유
3	결제 설정	선택사항이지만 권장
4	API 서비스 활성화	Gmail, Sheets, Calendar, Drive API (최소 4개)
5	OAuth 동의 화면 설정	외부(External) 선택
6	데이터 접근 범위 정하기	Gmail, Sheets, Calendar, Drive 스코프 추가
7	OAuth 2.0 클라이언트 ID 생성	클라이언트 ID와 시크릿 반드시 저장!
8	테스트 앱 설정	본인 이메일을 테스트 사용자로 추가
9	n8n에서 Google 인증 정보 등록	Connected 상태 확인

STEP 1. GCP 가입하기

GCP는 기존 Google 계정(Gmail 등 Google 계정)으로 바로 이용할 수 있습니다. 별도의 가입 절차가 필요 없거든요. Gmail 계정이 있으면 이미 준비 완료입니다.

접속 방법

1. 웹 브라우저(Chrome 권장)를 열고, 주소창에 아래 URL을 입력합니다.

https://console.cloud.google.com

2. Google 계정으로 로그인합니다. (이미 로그인 상태라면 바로 콘솔 화면이 나타납니다.)

3. 처음 접속하면 이용약관 동의 화면이 표시됩니다.

   • 서비스 약관에 동의 체크박스를 클릭합니다.
   • 이메일 업데이트 수신 여부는 선택사항입니다. 원하지 않으면 체크하지 않아도 됩니다.
   • 하단의 동의 및 계속하기 버튼을 클릭합니다.

4. 동의를 완료하면 GCP 대시보드가 표시됩니다. 화면 상단에 Google Cloud 로고, 프로젝트 선택 드롭다운, 검색창이 보이면 정상적으로 접속된 것입니다.

STEP 2. 무료 크레딧 $300 활용하기

GCP는 신규 사용자에게 $300 상당의 무료 크레딧을 제공합니다. n8n 연동에 사용하는 Google Workspace API(Gmail, Sheets, Calendar, Drive)는 대부분 무료 할당량(quota) 내에서 사용할 수 있어, 개인 학습이나 소규모 자동화 용도로는 비용이 거의 발생하지 않습니다.

무료 체험 시작 방법

1. GCP 콘솔 상단에 "무료로 시작하기" 또는 "무료 체험 활성화" 배너가 나타납니다. 이 배너를 클릭합니다.

2. 1단계 — 계정 정보: 국가를 대한민국으로 선택하고, 이용약관에 동의한 뒤 계속 버튼을 클릭합니다.

3. 2단계 — 결제 정보: 결제 수단(신용카드 또는 체크카드)의 카드 번호, 유효기간, CVC를 입력합니다. 입력 후 무료 체험 시작 버튼을 클릭합니다.

[💡] 카드를 등록해도 바로 결제되지 않습니다 무료 체험 기간이 끝나면 유료 계정으로 수동 업그레이드하기 전까지 과금되지 않습니다. Google이 자동으로 결제하지 않으므로 안심하세요.

무료 크레딧 조건

과금 방지 방법

• 무료 체험 종료 후 유료 계정으로 업그레이드하지 않으면 서비스가 중지될 뿐, 자동 과금은 되지 않습니다.
• 만약 유료 계정으로 업그레이드한 경우, 예산 알림을 설정하여 예상치 못한 과금을 방지할 수 있습니다. (STEP 3의 '예산 알림 설정'에서 안내합니다.)

⚠️ 주의: n8n에서 구글 API를 사용하기 위해 무료 체험을 반드시 활성화할 필요는 없습니다. 그러나 일부 API는 결제 계정이 연결된 프로젝트에서만 사용할 수 있으므로, 결제 정보 등록을 권장합니다.

STEP 3. 프로젝트 생성하기

GCP에서는 모든 리소스(API, 인증 정보 등)를 프로젝트 단위로 관리합니다. 여기서 말하는 '프로젝트'는 일반적인 업무 프로젝트가 아니라, GCP에서 API와 인증 정보를 묶어 관리하는 하나의 작업 공간 같은 개념이에요. n8n 연동을 위한 전용 프로젝트를 하나 만들어 봅시다.

새 프로젝트 만들기

1. GCP 콘솔 상단 바에서 "프로젝트 선택" 드롭다운(Google Cloud 로고 오른쪽에 있습니다)을 클릭합니다.

2. 팝업 창이 열리면, 우측 상단의 새 프로젝트 버튼을 클릭합니다.

3. 새 프로젝트 화면에서 아래 정보를 입력합니다.

4. 입력을 마쳤으면 만들기 버튼을 클릭합니다.

5. 프로젝트 생성이 완료되면, 상단 바의 프로젝트 이름 영역에 방금 만든 프로젝트 이름이 표시됩니다. 만약 다른 프로젝트가 선택되어 있다면, 드롭다운을 클릭하여 방금 만든 프로젝트를 선택합니다.

[✔️] 프로젝트 이름 vs 프로젝트 ID 프로젝트를 만들면 프로젝트 ID가 자동 생성됩니다. 프로젝트 이름은 나중에 변경할 수 있지만, 프로젝트 ID는 변경할 수 없습니다. 프로젝트 ID는 my-n8n-automation-12345와 같은 형태로, 고유한 식별자 역할을 합니다. 대부분의 경우 프로젝트 이름만 기억하면 됩니다.

STEP 4. 결제 설정

일부 Google API는 결제 계정이 연결된 프로젝트에서만 사용할 수 있습니다. 📍STEP 2에서 무료 체험을 활성화했다면 결제 계정이 자동으로 연결되므로, 이 단계는 건너뛰어도 됩니다. 무료 체험을 건너뛴 분만 아래 절차를 따라주세요.

결제 계정 연결

1. GCP 콘솔 좌측 상단의 **햄버거 메뉴(≡)**를 클릭합니다.
2. 펼쳐지는 탐색 메뉴에서 **결제(Billing)**를 클릭합니다.
3. 결제 계정 연결 또는 결제 계정 만들기를 선택합니다.
4. 안내에 따라 국가, 계정 유형(개인), 결제 정보(카드 번호)를 순서대로 입력합니다.
5. 모든 입력이 끝나면 제출 버튼을 클릭합니다.

예산 알림 설정 (과금 방지)

유료 계정으로 업그레이드한 경우, 예산 알림을 설정하면 예상치 못한 과금을 방지할 수 있습니다.

1. 결제 메뉴 좌측에서 **예산 및 알림(Budgets & alerts)**을 클릭합니다.
2. 상단의 예산 만들기(Create Budget) 버튼을 클릭합니다.
3. 예산 이름(예: n8n 예산)을 입력하고, 목표 금액을 설정합니다 (예: $10).
4. 알림 기준을 설정합니다. 기본값으로 예산의 50%, 90%, 100% 도달 시 이메일 알림이 발송됩니다.
5. 마침 버튼을 클릭하여 저장합니다.

[✔️] 과금 방지 팁 n8n에서 사용하는 Google Workspace API(Gmail, Sheets, Calendar, Drive)는 일일 무료 할당량이 넉넉합니다. 개인 사용 수준에서는 유료 과금이 발생할 일이 거의 없거든요. 그래도 안심을 위해 예산 알림을 $5~$10 수준으로 설정해 두면 좋습니다.

STEP 5. API 서비스 활성화

n8n에서 구글 서비스를 사용하려면, 해당 서비스의 API를 활성화해야 합니다. API를 활성화한다는 것은 "이 프로젝트에서 해당 구글 서비스를 사용하겠다"라고 선언하는 것이에요.

API 라이브러리로 이동하기

1. GCP 콘솔 좌측 햄버거 메뉴(≡)를 클릭합니다.
2. **API 및 서비스(APIs & Services)**를 클릭하면 하위 메뉴가 펼쳐집니다.
3. **라이브러리(Library)**를 클릭합니다.

탐색 메뉴 → 'API 및 서비스' → '라이브러리' 경로

💡 빠른 이동: 상단 검색창에 API Library를 입력해서 바로 이동할 수도 있습니다.

4. API 라이브러리 메인 화면이 나타납니다. 상단에 검색창이 보이고, 아래에 카테고리별 API 목록이 나열됩니다.

API 라이브러리 메인 화면 — 검색창 위치

활성화할 API 목록

n8n에서 자주 사용하는 구글 서비스에 대해 다음 API를 활성화합니다:

API 활성화 절차

아래 절차를 위 표의 각 API마다 반복합니다. Gmail API를 예시로 설명하겠습니다.

1. API 라이브러리 상단 검색창에 Gmail API를 입력합니다.

2. 검색 결과에서 Gmail API를 클릭합니다. (Google 공식 아이콘이 붙어 있는 항목을 선택하세요.)

3. Gmail API 상세 페이지가 열립니다. 파란색 사용(Enable) 버튼을 클릭합니다.

4. 잠시 기다리면 활성화가 완료됩니다. "API가 사용 설정되었습니다(API enabled)" 메시지가 나타나면 성공입니다.

5. 같은 방법으로 나머지 API도 하나씩 활성화합니다. API 라이브러리로 돌아가려면 좌측 메뉴에서 라이브러리를 다시 클릭하면 됩니다.

   • 검색창에 Google Sheets API 입력 → 클릭 → 사용 클릭
   • 검색창에 Google Calendar API 입력 → 클릭 → 사용 클릭
   • 검색창에 Google Drive API 입력 → 클릭 → 사용 클릭
   • 검색창에 Google Slides API 입력 → 클릭 → 사용 클릭

[✔️] 5개 모두 활성화하는 데 2~3분이면 충분합니다 나중에 n8n에서 구글 노드를 사용할 때마다 다시 GCP에 들어올 필요가 없으니, 이 기회에 한꺼번에 활성화해 두세요.

[!warning] 프로젝트 확인 필수! 반드시 STEP 3에서 생성한 프로젝트(예: my-n8n-automation)가 상단 바에서 선택된 상태에서 API를 활성화하세요. 다른 프로젝트가 선택된 상태에서 활성화하면, 나중에 인증 정보와 연결이 안 됩니다.

활성화된 API 확인하기

모든 API를 활성화한 후, 제대로 되었는지 확인해 봅시다.

1. 좌측 메뉴에서 API 및 서비스 → **사용 설정된 API 및 서비스(Enabled APIs & services)**를 클릭합니다.
2. 방금 활성화한 5개 API가 목록에 표시되면 성공입니다.

STEP 6. OAuth 동의 화면 설정

구글은 여러분의 데이터를 아무 앱에나 넘겨주지 않습니다. OAuth는 "이 앱(n8n)이 내 구글 데이터에 접근해도 좋다"는 허가증을 발급하는 과정이에요. 비밀번호를 직접 알려주는 대신, 구글이 중간에서 "정말 허락할 건가요?"라고 확인해 주는 안전한 방식이죠.

OAuth 동의 화면은 사용자가 구글 계정으로 로그인할 때 "이 앱이 여러분의 데이터에 접근해도 되겠습니까?"라고 묻는 화면입니다. n8n이 여러분의 구글 데이터에 접근할 수 있도록 이 동의 화면을 설정해야 합니다.

OAuth 동의 화면으로 이동

1. GCP 콘솔 좌측 햄버거 메뉴(≡) → API 및 서비스(APIs & Services) → **OAuth 동의 화면(OAuth consent screen)**을 클릭합니다.

2. OAuth 동의 화면 설정 페이지가 열립니다. "시작하기(Get Started)" 또는 앱 정보 입력 폼이 바로 표시됩니다.

앱 정보 입력

아래 표를 참고하여 각 항목을 입력합니다.

[✅] '대상' 선택: 반드시 '외부(External)'를 선택하세요 내부(Internal) 옵션은 Google Workspace(구 G Suite) 유료 조직 계정에서만 사용할 수 있습니다. 일반 Gmail 계정이라면 **외부(External)**만 선택 가능합니다. '외부'를 선택해도 나중에 테스트 사용자를 등록하면 본인만 사용하는 앱으로 안전하게 운영할 수 있으니 걱정하지 마세요.

3. 모든 항목을 입력한 후, 하단의 저장 후 계속(Save and Continue) 버튼을 클릭합니다.

STEP 7. n8n이 접근할 구글 데이터 범위 정하기 (스코프 설정)

**스코프(Scope)**는 앱이 사용자의 어떤 데이터에 접근할 수 있는지를 정의하는 설정입니다. 쉽게 말해 "이 앱이 내 메일을 볼 수 있나요? 내 캘린더를 수정할 수 있나요?"를 정하는 것이죠.

스코프 추가 방법

1. OAuth 동의 화면 설정 좌측 메뉴에서 데이터 액세스(Data access) 탭을 클릭합니다. (STEP 6에서 저장 후 자동으로 이동될 수도 있습니다.)

2. 범위 추가 또는 삭제(Add or Remove Scopes) 버튼을 클릭합니다.

3. 우측에 스코프 선택 패널이 열립니다. 상단에 필터(Filter) 검색창이 있습니다.

필요한 스코프 추가하기

아래 표의 스코프를 하나씩 찾아 체크합니다. 필터 검색창에 서비스 이름을 입력하면 빠르게 찾을 수 있습니다.

스코프 검색 및 선택 방법 (Gmail 예시):

1. 필터 검색창에 mail.google을 입력합니다.
2. 결과 목록에서 https://mail.google.com/ 항목의 체크박스를 클릭합니다.
3. 검색어를 지우고, 다음 스코프를 검색합니다.
4. 4개 스코프를 모두 체크했으면 패널 하단의 업데이트(Update) 버튼을 클릭합니다.

[✅] 스코프를 못 찾겠다면 — 수동 입력 필터에서 원하는 스코프가 보이지 않으면, 패널 하단의 수동으로 범위 추가(Manually add scopes) 영역에 아래 URL을 한 줄씩 붙여넣고 범위 추가 버튼을 클릭하세요.

https://mail.google.com/
https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/drive

[⚠️] Gmail 스코프는 '민감한 범위'입니다 Gmail 스코프(https://mail.google.com/)는 **민감한 범위(Sensitive scope)**로 분류됩니다. 테스트 모드에서는 문제없이 사용할 수 있지만, 프로덕션(정식 게시)으로 전환하려면 Google의 검증 절차가 필요합니다. 개인 학습 용도로는 테스트 모드로 충분하니 걱정하지 않으셔도 됩니다.

5. 스코프 패널이 닫히고, 선택한 스코프 목록이 화면에 표시됩니다. 4개가 모두 나열되어 있는지 확인합니다.

6. 📍 화면 하단의 저장(Save) 버튼을 반드시 클릭합니다.

STEP 8. OAuth 2.0 클라이언트 ID 생성

이제 n8n이 구글 서비스에 접근할 때 사용할 인증 열쇠(클라이언트 ID와 클라이언트 시크릿)를 만들겠습니다. ==이 단계가 전체 설정에서 가장 중요합니다.==

사용자 인증 정보 페이지로 이동

1. GCP 콘솔 좌측 메뉴에서 API 및 서비스(APIs & Services) → **사용자 인증 정보(Credentials)**를 클릭합니다.

2. 사용자 인증 정보 페이지가 열립니다. 아직 인증 정보가 없으므로 빈 화면이 보일 수 있습니다.

OAuth 클라이언트 ID 만들기

3. 상단의 + 사용자 인증 정보 만들기(+ Create Credentials) 버튼을 클릭합니다.

4. 드롭다운 메뉴가 나타납니다. **OAuth 클라이언트 ID(OAuth client ID)**를 선택합니다.

클라이언트 ID 설정

5. OAuth 클라이언트 ID 만들기 화면에서 아래 정보를 입력합니다.

승인된 리디렉션 URI 설정 (매우 중요!)

이 설정이 빠지거나 잘못되면 n8n에서 구글 로그인이 실패합니다. 리디렉션 URI란 구글 로그인 후 인증 결과를 돌려받을 주소예요.

6. 화면을 아래로 스크롤하여 승인된 리디렉션 URI(Authorized redirect URIs) 섹션을 찾습니다.

7. + URI 추가(+ Add URI) 버튼을 클릭합니다.

8. 입력 필드가 나타납니다. 사용 중인 n8n 환경에 맞는 URI를 입력합니다. 아래 세 가지 중 자신의 환경에 해당하는 URI 하나만 입력하세요.

예를 들어, dantelabs-n8n.dante-labs.com이라는 도메인으로 n8n을 운영 중이라면:

https://dantelabs-n8n.dante-labs.com/rest/oauth2-credential/callback

[⚠️] 리디렉션 URI는 한 글자도 틀리면 안 됩니다! 대소문자, 슬래시(/) 하나까지 정확히 일치해야 합니다. 끝에 슬래시를 붙이거나 빠뜨리면 redirect_uri_mismatch 오류가 발생합니다. 반드시 복사-붙여넣기를 활용하세요.

흔한 실수:

• http와 https 혼동
• 끝에 / 유무 차이
• 도메인명 오타
• 로컬 환경에서 포트 번호(:5678) 누락

[💡] n8n에서 리디렉션 URI 확인하는 방법 n8n에서 Google OAuth2 Credential을 생성하면, 설정 화면 상단에 OAuth Redirect URL이 표시됩니다. 이 값을 그대로 GCP에 입력하면 됩니다.

클라이언트 ID와 시크릿 저장

9. 모든 입력을 마쳤으면 하단의 만들기(Create) 버튼을 클릭합니다.

10. 클라이언트 ID와 **클라이언트 시크릿(Client Secret)**이 포함된 팝업이 나타납니다.

[⚠️] 반드시 지금 복사하여 안전한 곳에 저장하세요! 2025년 6월 이후 생성된 클라이언트의 시크릿은 생성 시점에만 전체 값을 볼 수 있습니다. 이 팝업을 닫으면 시크릿 전체 값을 다시 확인할 수 없으며, 새로 생성해야 합니다.

11. 클라이언트 ID 옆의 복사 아이콘(📋)을 클릭하여 복사한 후, 메모장이나 비밀번호 관리 앱에 붙여넣습니다.
12. 클라이언트 시크릿 옆의 복사 아이콘(📋)을 클릭하여 복사한 후, 같은 곳에 붙여넣습니다.

저장할 값 형식:

클라이언트 ID: xxxxxxxxxxxx.apps.googleusercontent.com
클라이언트 시크릿: GOCSPX-xxxxxxxxxxxxxxxxxxxxxxxx

💡 안전한 저장 방법: 메모장이나 비밀번호 관리 앱(예: 1Password, Bitwarden)에 저장하세요. 카카오톡이나 이메일로 전송하는 것은 보안상 권장하지 않습니다.

13. 확인을 마쳤으면 확인(OK) 버튼을 클릭하여 팝업을 닫습니다.

STEP 9. 테스트 앱 설정

외부(External) 유형으로 만든 앱은 기본적으로 **테스트 모드(Testing)**로 시작합니다. 테스트 모드에서는 등록된 테스트 사용자만 앱을 사용할 수 있으므로, 본인의 Google 이메일을 테스트 사용자로 추가해야 합니다.

테스트 사용자 추가

1. GCP 콘솔 좌측 메뉴에서 API 및 서비스 → OAuth 동의 화면으로 이동합니다.

2. 좌측 하위 메뉴에서 Audience(대상) 페이지를 클릭합니다.

3. 화면을 스크롤하여 테스트 사용자(Test users) 섹션을 찾습니다.

4. + Add Users 버튼을 클릭합니다.

5. 이메일 입력 창이 나타납니다. 본인의 Google 이메일 주소를 입력합니다.

6. 저장(Save) 버튼을 클릭합니다.

7. 입력한 이메일이 테스트 사용자 목록에 추가된 것을 확인합니다.

테스트 모드 vs 프로덕션 모드

[💡] 개인 사용이라면 테스트 모드로 충분합니다 다만 테스트 모드에서는 OAuth 토큰이 7일마다 만료될 수 있습니다. n8n에서 구글 연결이 끊어졌다는 오류가 나오면 재인증하면 됩니다.

재인증 방법 (30초면 끝!):

1. n8n의 Credentials 메뉴에서 해당 Google Credential을 클릭하여 엽니다.
2. Sign in with Google 버튼을 다시 클릭합니다.
3. Google 로그인 → 권한 승인 → Connected 상태 확인

프로덕션 모드로 전환하면 토큰이 안정적으로 유지되지만, Gmail 같은 민감한 스코프를 사용할 경우 Google의 앱 검증 절차를 거쳐야 합니다.

STEP 10. n8n에서 Google 인증 정보 등록

GCP에서의 설정이 모두 끝났습니다! 이제 n8n으로 돌아가서 방금 만든 인증 정보를 등록합니다. 이 단계를 마치면 모든 설정이 완료됩니다.

생성해야 할 Credential 목록

n8n에서는 구글 노드 유형별로 각각 Credential을 생성해야 합니다. 같은 GCP 프로젝트의 Client ID/Secret을 사용하지만, n8n이 노드와 Credential 유형을 매칭하기 때문에 개별 생성이 필요하거든요.

[⚠️] Google Sheets와 Google Sheets Trigger는 다릅니다! 이름이 비슷하지만 서로 다른 Credential 유형입니다. 둘 다 만들어야 합니다.

[✅] 한꺼번에 만들 필요 없어요 4.1.54.1.6 실습만 진행한다면 **13번**(Sheets, Sheets Trigger, Gmail)만 먼저 만들면 됩니다. 4~5번(Drive, Slides)은 4.1.7 인증서 자동 생성 실습 시 추가하면 됩니다.

Credential 생성 절차

아래 절차를 위 표의 각 Credential마다 반복합니다. Google Sheets OAuth2 API를 예시로 설명하겠습니다.

1. n8n에 접속합니다.

2. 좌측 사이드바 또는 Overview 화면에서 Credentials 탭을 클릭합니다.

3. 우측 상단의 Create Credential 버튼을 클릭합니다.

4. Credential 유형 선택 화면이 나타납니다. 검색창에 Google Sheets를 입력합니다.

5. 검색 결과에서 Google Sheets OAuth2 API를 클릭합니다. (이름이 비슷한 항목이 여러 개 있으므로, 정확한 유형을 선택하세요.)

인증 정보 입력

6. Credential 설정 화면이 열립니다. 상단에 OAuth Redirect URL이 표시됩니다. (이 URL이 STEP 8에서 GCP에 입력한 리디렉션 URI와 일치하는지 확인하세요.)

7. 아래 두 필드에 STEP 8에서 저장한 값을 입력합니다.

💡 팁: 값을 붙여넣을 때 앞뒤에 공백이 들어가지 않도록 주의하세요. 공백이 포함되면 인증이 실패합니다.

서비스별 Scope 설정 (권장)

8. Credential 설정 화면 하단에 Scope 입력란이 있습니다. 여기에 스코프를 입력하면 해당 Credential이 접근할 수 있는 구글 데이터 범위를 지정할 수 있습니다.

[✅] 추천 — 모든 Credential에 동일한 Scope 입력 각 Credential을 만들 때마다 아래 스코프를 모두 동일하게 입력해 두면, 권한 부족 오류를 방지할 수 있습니다. 한 줄에 하나씩 입력하세요.

https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/presentations
https://mail.google.com/

Google 로그인 및 권한 승인

9. Sign in with Google 버튼을 클릭합니다.

10. 새 브라우저 창(또는 팝업)이 열리며 Google 로그인 화면이 나타납니다. 본인 계정을 선택하거나, 이메일과 비밀번호를 입력하여 로그인합니다.

11. "Google hasn't verified this app" (Google에서 확인하지 않은 앱입니다) 경고 화면이 나타납니다. 이 경고는 여러분이 직접 만든 앱이 Google의 공식 검증을 받지 않았기 때문에 나타나는 것입니다. 여러분이 만든 앱을 여러분이 직접 사용하는 것이므로 보안상 문제가 없습니다. 안심하고 진행하세요.

12. 화면 좌측 하단의 Advanced(고급) 링크를 클릭합니다.

13. 펼쳐진 텍스트 하단에 Go to n8n-automation (unsafe) 링크가 나타납니다. 이 링크를 클릭합니다.

14. 데이터 접근 권한 동의 화면이 나타납니다. n8n이 접근할 수 있는 데이터 항목(Gmail, Sheets, Calendar, Drive 등)이 나열됩니다. 모든 항목의 체크박스를 선택하고 하단의 Continue(계속) 버튼을 클릭합니다.

연결 성공 확인

15. 인증이 완료되면 n8n 화면으로 자동 복귀합니다. Credential 카드 상단에 초록색 Connected 배지가 표시됩니다.

16. 우측 상단의 Save 버튼을 클릭하여 저장합니다.

나머지 Credential 생성

17. 같은 절차(3~16번)를 반복하여 나머지 Credential도 생성합니다.

💡 팁: Client ID, Client Secret, Scope는 모든 Credential에 동일한 값을 입력합니다. 매번 같은 값을 복사-붙여넣기하면 됩니다.

18. 모든 Credential 생성이 끝나면 Credentials 목록에서 5개 모두 Connected 상태인지 확인합니다.

정리하며

설정 과정 요약

자주 발생하는 오류와 해결법

오류 1: redirect_uri_mismatch

증상: Google 로그인 시 "Error 400: redirect_uri_mismatch" 메시지가 나타남

원인: GCP에 등록한 리디렉션 URI와 n8n이 보내는 URI가 일치하지 않음

해결법

1. GCP 콘솔 → 사용자 인증 정보 → 해당 OAuth 클라이언트 ID 클릭
2. 승인된 리디렉션 URI가 n8n의 OAuth Redirect URL과 정확히 일치하는지 확인
3. 흔한 실수:
   • http와 https 혼동
   • 끝에 슬래시(/) 유무 차이
   • 도메인명 오타
   • 포트 번호 누락 (로컬 환경에서 :5678 빠짐)

오류 2: access_denied

증상: Google 로그인 후 "Error 403: access_denied" 메시지가 나타남

원인: 테스트 사용자로 등록되지 않은 계정으로 로그인 시도

해결법

1. GCP 콘솔 → OAuth 동의 화면 → Audience(대상) 페이지
2. 테스트 사용자 목록에 로그인하려는 Google 이메일이 등록되어 있는지 확인
3. 등록되어 있지 않다면 + Add Users로 추가

오류 3: 400 에러 (잘못된 요청)

증상: "Error 400: invalid_request" 또는 빈 화면이 나타남

원인: 클라이언트 ID 또는 시크릿이 잘못 입력됨

해결법

1. n8n의 Credential 설정에서 Client ID와 Client Secret 값을 다시 확인
2. 값 앞뒤에 공백이 포함되지 않았는지 확인
3. 클라이언트 시크릿을 분실한 경우: GCP에서 새 시크릿을 생성하거나 OAuth 클라이언트 ID를 새로 만들기

오류 4: API 미활성화

증상: n8n에서 구글 노드 실행 시 "API has not been used in project" 또는 "Access Not Configured" 오류

원인: 해당 API가 GCP 프로젝트에서 활성화되지 않음

해결법

1. GCP 콘솔 → API 및 서비스 → 라이브러리
2. 오류에 언급된 API를 검색하여 사용(Enable) 클릭
3. API가 올바른 프로젝트에서 활성화되었는지 상단 바의 프로젝트명 확인

오류 5: 토큰 만료 (테스트 모드)

증상: 잘 되던 구글 노드가 갑자기 "Invalid credentials" 또는 "Token has been expired or revoked" 오류 발생

원인: 테스트 모드의 OAuth 토큰이 7일 후 만료됨

해결법

1. n8n의 Credentials 메뉴에서 오류가 발생한 Google Credential을 클릭
2. Sign in with Google 버튼을 다시 클릭
3. Google 로그인 → 권한 승인 → Connected 상태 확인
4. Save 클릭

💡 이 오류는 테스트 모드 특성상 약 7일마다 반복될 수 있습니다. 재인증은 30초면 끝나니 부담 없이 진행하세요.

설정 완료 체크리스트

모든 설정이 올바르게 완료되었는지 아래 체크리스트로 확인하세요:

• GCP 콘솔에 정상 접속 가능
• n8n 전용 프로젝트 생성 완료
• Gmail API 활성화
• Google Sheets API 활성화
• Google Calendar API 활성화
• Google Drive API 활성화
• Google Slides API 활성화
• OAuth 동의 화면 설정 완료 (외부 유형)
• 필요한 스코프 4개 추가 완료
• OAuth 클라이언트 ID 생성 완료
• 리디렉션 URI 정확히 입력
• 클라이언트 ID와 시크릿 안전한 곳에 저장
• 테스트 사용자에 본인 이메일 추가
• n8n에서 Credential 생성 및 Google 로그인 성공
• Credential 상태가 Connected 표시

위 항목이 모두 충족되면 n8n에서 Gmail, Google Sheets, Google Calendar, Google Drive, Google Slides 노드를 사용할 수 있는 상태가 된 것입니다.

💡 다음 단계: 워크플로에서 ChatGPT·Claude·Gemini 같은 LLM을 호출하려면 별도의 LLM API 키가 필요합니다. 다음으로 [[부록05_LLM_API_키_발급_가이드|부록 05. LLM API 키 발급 가이드]]를 참고하세요.