이 문서에는 커스텀 작업에서 사용할 범용 Google OAuth2 API 자격 증명을 생성하는 방법에 대한 안내가 포함되어 있습니다.

사전 요구 사항#

• Google Cloud 계정을 생성하세요.

OAuth 설정#

n8n 자격 증명을 Google 서비스에 연결하는 데는 다섯 단계가 있습니다.

1. Google Cloud Console 프로젝트 생성.
2. API 활성화.
3. OAuth 동의 화면 구성.
4. Google OAuth 클라이언트 자격 증명 생성.
5. n8n 자격 증명 완료.

Google Cloud Console 프로젝트 생성#

먼저 Google Cloud Console 프로젝트를 생성하세요. 이미 프로젝트가 있다면 다음 섹션으로 건너뛰세요.

API 활성화#

프로젝트를 생성했다면 액세스해야 할 API를 활성화하세요.

OAuth 동의 화면 구성#

Google Cloud 프로젝트에서 OAuth를 사용해본 적이 없다면 OAuth 동의 화면을 구성해야 합니다.

1. Google Cloud Console - Library에 접속하세요. 올바른 프로젝트에 있는지 확인하세요.

   

2. 왼쪽 내비게이션 메뉴를 열고 APIs & Services > OAuth consent screen으로 이동하세요. Google이 Google Auth Platform 개요 페이지로 리디렉션합니다.

3. Overview 탭에서 Get started를 선택하여 OAuth 동의 구성을 시작하세요.

4. OAuth 화면에 표시할 App name과 User support email을 입력하세요. Next를 선택하여 계속하세요.

5. Audience의 경우, 조직의 Google 워크스페이스 내 사용자만 접근하도록 하려면 Internal을, Google 계정이 있는 모든 사용자가 접근하도록 하려면 External을 선택하세요. 사용자 유형에 대한 자세한 내용은 Google의 User type 문서를 참고하세요. Next를 선택하여 계속하세요.

6. 프로젝트 변경 사항에 대해 Google이 연락할 때 사용할 Email addresses를 선택하세요. Next를 선택하여 계속하세요.

7. Google의 사용자 데이터 정책을 읽고 동의하세요. Continue를 선택한 다음 Create를 선택하세요.

8. 왼쪽 메뉴에서 Branding을 선택하세요.

9. Authorized domains 섹션에서 Add domain을 선택하세요.

   • n8n의 Cloud 서비스를 사용 중이라면 n8n.cloud를 추가하세요.
   • 셀프 호스팅 중이라면 n8n 인스턴스의 도메인을 추가하세요.

10. 페이지 하단의 Save를 선택하세요.

Google OAuth 클라이언트 자격 증명 생성#

다음으로 Google에서 OAuth 클라이언트 자격 증명을 생성하세요.

1. Google Cloud Console에 접속하세요. 올바른 프로젝트에 있는지 확인하세요.
2. APIs & Services 섹션에서 Credentials를 선택하세요.
3. + Create credentials > OAuth client ID를 선택하세요.
4. Application type 드롭다운에서 Web application을 선택하세요.
5. Google이 Name을 자동으로 생성합니다. 콘솔에서 알아보기 쉬운 이름으로 Name을 수정하세요.
6. n8n 자격 증명에서 OAuth Redirect URL을 복사하세요. 이를 Google Console의 Authorized redirect URIs에 붙여넣으세요.
7. Create를 선택하세요.

n8n 자격 증명 완료#

Google 프로젝트와 자격 증명 설정을 모두 마쳤다면 n8n 자격 증명을 완료하세요.

1. Google의 OAuth client created 모달에서 Client ID를 복사하세요. 이를 n8n 자격 증명에 입력하세요.

2. 같은 Google 모달에서 Client Secret을 복사하세요. 이를 n8n 자격 증명에 입력하세요.

3. 이 자격 증명에 사용할 스코프를 제공해야 합니다. 자세한 내용은 Scopes를 참고하세요. 여러 스코프는 공백으로 구분된 목록으로 입력하세요. 예:

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

4. n8n에서 Sign in with Google을 선택하여 Google 인증을 완료하세요.

5. 새 자격 증명을 Save하세요.

영상#

위에서 설명한 단계는 다음 영상으로도 확인할 수 있습니다.

스코프#

Google 서비스에는 하나 이상의 접근 스코프가 있습니다. 스코프는 사용자가 수행할 수 있는 작업을 제한합니다. 모든 서비스의 스코프 목록은 OAuth 2.0 Scopes for Google APIs를 참고하세요.

n8n은 모든 스코프를 지원하지는 않습니다. 범용 Google OAuth2 API 자격 증명을 생성할 때, 아래 Supported scopes 목록에 있는 스코프를 입력할 수 있습니다. n8n이 아직 지원하지 않는 스코프를 입력하면 작동하지 않습니다.

지원되는 스코프

Service	Available scopes
Gmail	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
Google Ads	https://www.googleapis.com/auth/adwords
Google Analytics	https://www.googleapis.com/auth/analytics https://www.googleapis.com/auth/analytics.readonly
Google BigQuery	https://www.googleapis.com/auth/bigquery
Google Books	https://www.googleapis.com/auth/books
Google Calendar	https://www.googleapis.com/auth/calendar https://www.googleapis.com/auth/calendar.events
Google Cloud Natural Language	https://www.googleapis.com/auth/cloud-language https://www.googleapis.com/auth/cloud-platform
Google Cloud Storage	https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/cloud-platform.read-only https://www.googleapis.com/auth/devstorage.full_control https://www.googleapis.com/auth/devstorage.read_only https://www.googleapis.com/auth/devstorage.read_write
Google Contacts	https://www.googleapis.com/auth/contacts
Google Docs	https://www.googleapis.com/auth/documents https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.file
Google Drive	https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.appdata https://www.googleapis.com/auth/drive.photos.readonly
Google Firebase Cloud Firestore	https://www.googleapis.com/auth/datastore https://www.googleapis.com/auth/firebase
Google Firebase Realtime Database	https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/firebase.database https://www.googleapis.com/auth/firebase
Google Perspective	https://www.googleapis.com/auth/userinfo.email
Google Sheets	https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/spreadsheets
Google Slide	https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/presentations
Google Tasks	https://www.googleapis.com/auth/tasks
Google Translate	https://www.googleapis.com/auth/cloud-translation
GSuite Admin	https://www.googleapis.com/auth/admin.directory.group https://www.googleapis.com/auth/admin.directory.user https://www.googleapis.com/auth/admin.directory.domain.readonly https://www.googleapis.com/auth/admin.directory.userschema.readonly

문제 해결#

Google에서 이 앱을 확인하지 않았습니다#

Google Cloud 앱이 인가되지 않은 상태가 되는 경우#