Google에 읽기 전용 액세스를 요청하려면 SaaSMaestro에 Google Cloud 프로젝트의 OAuth 클라이언트가 필요합니다. 워크스페이스마다 데이터 연결 탭에서 설정하는 자체 클라이언트가 있으며, 하나의 Google Cloud 프로젝트로 모두 지원할 수 있습니다.
먼저 확인하세요: 워크스페이스의 설정 → 데이터 연결을 열고 “Google OAuth 설정” 상자를 확인하세요. “구성됨” 또는 “.env에서 구성됨”으로 표시되면 이미 완료된 것이므로 바로 Google 계정 연결로 넘어가면 됩니다.
수행할 수 있는 사람
보고 있는 워크스페이스의 소유자와 관리자. 이 변경은 워크스페이스에 속한 모든 사람의 Google 로그인 방식에 영향을 주므로, 최근 15분 안에 비밀번호를 입력하지 않았다면 다시 입력하라는 요청을 받습니다.
단계별 안내
워크스페이스의 데이터 연결 탭에서 “Google OAuth 설정” 상자를 클릭하세요. 설정 창에서 다음 다섯 단계를 차례로 안내합니다:
- Google Cloud 프로젝트를 만들거나 선택하세요. 어떤 프로젝트든 상관없습니다.
- 세 가지 API를 사용 설정하세요: Google Analytics Admin API, Google Analytics Data API, Google Search Console API.
- 동의 화면을 구성하세요. 연결할 모든 Google 계정이 내 Google Workspace에 속해 있다면 “Internal”을 선택하세요. 그렇지 않으면 “External”을 선택하고, 앱이 Testing 모드인 동안 연결할 각 Google 계정을 테스트 사용자로 추가하세요.
- “Web application” 유형의 OAuth 클라이언트를 만들고 설정 창에 표시된 리디렉션 URI를 추가하세요. 정확히 일치하도록 복사 버튼을 사용하세요.
- 클라이언트 사용자 인증 정보를 붙여넣으세요: Client ID와 Client secret을 입력한 다음 “사용자 인증 정보 저장”을 클릭하세요.
설정 테스트
- 사용자 인증 정보 테스트는 로그인 없이 Google에서 Client ID와 secret을 확인합니다.
- 로그인 테스트는 전체 Google 로그인 과정을 실행하고, 성공하면 해당 계정을 워크스페이스에 연결합니다.
클라이언트 secret은 암호화되어 저장됩니다. Client ID만 변경하려면 secret 필드를 비워 두세요. 저장된 secret이 유지됩니다. “저장된 사용자 인증 정보 삭제”를 누르면 삭제됩니다.
자주 발생하는 오류
| Google 메시지 | 해야 할 일 |
|---|---|
redirect_uri_mismatch | Google Cloud의 리디렉션 URI가 정확히 일치하지 않습니다. http 또는 https와 뒤쪽 경로까지 포함해 설정 창에서 다시 복사하세요. |
access_denied | 동의 화면이 External이고 Testing 모드인데, 이 Google 계정이 테스트 사용자가 아닙니다. 동의 화면의 테스트 사용자에 추가하세요. |
| API가 사용 설정되지 않음 | 프로젝트에서 세 가지 API 중 하나가 사용 설정되지 않았습니다. 사용 설정하고 1분 정도 기다린 후 다시 시도하세요. |
invalid_client | Client ID 또는 secret이 잘못되었거나 클라이언트가 삭제되었습니다. 새 사용자 인증 정보를 붙여넣으세요. |
다음: Google 계정 연결.