Google Search Console API 연결 방법 - OAuth Client ID·Secret 발급 및 redirect_uri_mismatch 해결
워드프레스 플러그인이나 직접 만든 SEO 도구에서 Google Search Console 데이터를 불러오려고 하면 단순히 Search Console 사이트만 등록해서는 연결되지 않는 경우가 있습니다.
저도 Search Console의 검색어·노출수·클릭수·CTR·평균 게재순위를 가져오도록 설정하면서 Google OAuth 인증을 연결했는데, 처음에는 아래와 같이 400 오류: redirect_uri_mismatch가 발생했습니다.
결론부터 말하면 Google Search Console API 연동에 필요한 값은 크게 Google OAuth Client ID, Client Secret, Search Console 속성값 3가지입니다.
Google Search Console 자체의 사이트 등록과
Search Console API OAuth 연결은 서로 다른 작업입니다.
사이트가 Search Console에 이미 등록되어 있더라도
API를 이용하려면 Google Cloud에서 OAuth 클라이언트를 별도로 만들어야 합니다.
Google Search Console 연동 시 입력해야 하는 OAuth 정보 3가지
Google Search Console OAuth 연결 순서
1. Search Console API 연결 전 준비
2. Google Search Console API 활성화
3. OAuth 동의 화면 설정
4. OAuth Client ID와 Secret 발급
5. 승인된 리디렉션 URI 등록
6. Search Console 속성값 확인
7. redirect_uri_mismatch 오류 해결
8. 최종 입력값 확인
9. 자주 묻는 질문
Google Search Console API 연결 전 준비사항
먼저 API 연결에 사용할 Google 계정에서 해당 사이트가 Google Search Console에 등록되어 있어야 합니다.
특히 OAuth 인증에 사용하는 Google 계정이 Search Console 속성에 접근할 수 없는 계정이라면 Client ID와 Secret을 정상적으로 만들어도 사이트 데이터를 가져오지 못합니다.
| 확인 항목 | 필요 여부 | 설명 |
|---|---|---|
| Search Console 사이트 등록 | 필수 | 도메인 또는 URL 접두어 속성 등록 |
| Google Cloud 프로젝트 | 필수 | OAuth Client ID 발급에 사용 |
| Search Console API | 필수 | Search Console 데이터를 API로 호출 |
| OpenAI API Key | 별도 | Search Console OAuth 인증을 대신하지 못함 |
Google Cloud에서 Search Console API 활성화
Google Cloud Console에서 먼저 사용할 프로젝트를 선택합니다. 기존 프로젝트가 있다면 그대로 사용해도 되고, SEO 도구 전용으로 별도 프로젝트를 만들어 관리해도 됩니다.
좌측 메뉴에서 API 및 서비스 → 라이브러리로 이동한 뒤 Google Search Console API를 검색해 활성화합니다.
OAuth Client ID만 만들어 놓고 Search Console API를 활성화하지 않으면 인증은 되더라도 실제 데이터를 호출하는 단계에서 문제가 발생할 수 있습니다.
Google Cloud 사용자 인증 정보 메뉴 들어가기
Google Cloud Console 좌측 상단의 메뉴 버튼을 누르면 API 및 서비스 항목을 찾을 수 있습니다.
여기서 API 및 서비스 → 사용자 인증 정보를 선택합니다.
최근 Google Cloud에서는 기존의 OAuth 동의 화면 메뉴와 함께 Google Auth Platform이라는 이름으로 Branding, Audience, Clients, Data Access 등을 나눠 보여주는 경우도 있습니다. 메뉴 명칭이 조금 달라도 기능은 동일합니다.
OAuth 동의 화면도 먼저 설정
OAuth 클라이언트를 처음 만드는 프로젝트라면 OAuth 동의 화면을 먼저 설정해야 할 수 있습니다.
- 앱 이름 : 예) Yellow AI SEO
- 사용자 지원 이메일 : 본인 Google 계정
- 대상 사용자 : 외부(External)
- 테스트 사용자 : 실제 연결할 Google 계정 추가
- 연락처 이메일 : 본인 이메일
외부(External) 앱을 테스트 상태로 사용하는 경우에는 실제로 로그인할 Google 계정을 테스트 사용자로 등록해 두는 것이 좋습니다.
Google OAuth Client ID 만들기
사용자 인증 정보 화면으로 들어오면 상단에 + 사용자 인증 정보 만들기 버튼이 있습니다.
버튼을 누르면 API 키, OAuth 클라이언트 ID, 서비스 계정 등이 표시됩니다.
여기서는 OAuth 클라이언트 ID를 선택합니다.
애플리케이션 유형은 웹 애플리케이션
워드프레스 관리자 페이지에서 인증을 받아 다시 워드프레스로 돌아오는 방식이라면 애플리케이션 유형을 웹 애플리케이션으로 선택합니다.
이름은 실제 기능에는 큰 영향을 주지 않으므로 나중에 알아보기 쉬운 이름을 사용하면 됩니다.
애플리케이션 유형 : 웹 애플리케이션
이름 : Yellow AI SEO - GSC 연동
승인된 리디렉션 URI가 가장 중요
OAuth 설정에서 가장 많이 막히는 부분이 승인된 리디렉션 URI입니다.
제가 사용한 플러그인 화면에서는 다음과 같은 Redirect URI를 제공하고 있었습니다.
https://decreyellow.co.kr/wp-admin/admin.php?page=yellow-ai-seo&yai_gsc_callback=1
이 주소를 임의로 수정하지 말고 Google Cloud의 승인된 리디렉션 URI → URI 추가에 그대로 붙여 넣습니다.
Redirect URI에서 특히 확인할 부분
| 확인 항목 | 예시 |
|---|---|
| HTTPS | https:// |
| www 유무 | decreyellow.co.kr ≠ www.decreyellow.co.kr |
| 경로 | /wp-admin/admin.php |
| 쿼리값 | page=yellow-ai-seo&yai_gsc_callback=1 |
| 마지막 / | 있음과 없음도 서로 다르게 판단될 수 있음 |
Redirect URI는 비슷하게 입력하는 것이 아니라 플러그인이 Google에 전달하는 redirect_uri와 Google Cloud에 등록한 URI가 정확히 같아야 합니다.
Client ID와 Client Secret 복사하기
OAuth 클라이언트를 생성하면 클라이언트 ID와 클라이언트 보안 비밀번호(Client Secret)가 표시됩니다.
오른쪽 복사 버튼을 눌러 각각 보관한 뒤 워드프레스 플러그인의 다음 두 칸에 입력합니다.
- 1번 → Google OAuth Client ID
- 2번 → Google OAuth Client Secret
Client Secret은 비밀번호와 비슷하게 취급하는 것이 좋습니다. 블로그 캡처 화면이나 게시글에 실제 Secret 값을 그대로 노출하지 마세요.
Search Console 속성값은 무엇을 입력할까?
세 번째 칸은 Google Cloud 값이 아니라 Google Search Console에 등록되어 있는 속성값을 입력합니다.
Search Console 좌측 상단의 속성 선택 메뉴를 열면 현재 등록된 사이트를 확인할 수 있습니다.
여기서 중요한 점은 도메인 속성과 URL 접두어 속성의 입력 형식이 다르다는 것입니다.
도메인 속성인 경우
Search Console에 decreyellow.co.kr과 같이 도메인 속성으로 등록했다면 API에서 사용하는 속성값은 앞에 sc-domain:을 붙입니다.
sc-domain:decreyellow.co.kr
URL 접두어 속성인 경우
URL 접두어 방식으로 등록한 사이트라면 Search Console에 등록되어 있는 주소를 그대로 사용합니다.
https://decreyellow.co.kr/
| Search Console 등록방식 | 플러그인 입력값 |
|---|---|
| 도메인 속성 | sc-domain:decreyellow.co.kr |
| URL 접두어 속성 | https://decreyellow.co.kr/ |
400 오류 redirect_uri_mismatch가 뜬다면?
저도 설정 후 Google 계정으로 로그인하자 바로 정상 연결되지 않고 다음과 같은 화면이 표시됐습니다.
Google OAuth 400 오류 : redirect_uri_mismatch
오류 메시지는 다음과 같습니다.
400 오류: redirect_uri_mismatch
이 오류는 대부분 Client ID 자체가 잘못된 것이 아니라 Google에 실제 전달된 Redirect URI와 Google Cloud에 등록한 승인된 리디렉션 URI가 서로 다를 때 발생합니다.
redirect_uri_mismatch 해결 체크리스트
- Google Cloud → 사용자 인증 정보로 이동합니다.
- 사용 중인 OAuth 2.0 클라이언트 ID를 선택합니다.
- 승인된 리디렉션 URI를 확인합니다.
- 플러그인 화면에 표시된 OAuth Redirect URI를 다시 복사합니다.
- Google Cloud 값과 한 글자씩 비교합니다.
- http / https가 같은지 확인합니다.
- www 유무를 확인합니다.
- 마지막 슬래시 / 여부를 확인합니다.
- 쿼리 문자열까지 동일한지 확인합니다.
- 저장한 뒤 잠시 후 다시 인증합니다.
Client ID와 Secret을 새로 만드는 것보다 먼저 Redirect URI가 정확히 등록되어 있는지 확인하는 것이 중요했습니다. 특히 관리자 경로와
?page=... 뒤의 파라미터까지 같아야 합니다.
오류 수정이 바로 반영되지 않을 수도 있음
Google Cloud에서 OAuth 설정을 변경한 직후에는 설정이 즉시 반영되지 않는 경우도 있습니다.
URI가 정확한데 계속 같은 오류가 나온다면 몇 분 정도 기다린 뒤 브라우저를 새로 열어 다시 인증해 보는 것도 좋습니다.
Search Console 읽기 권한 Scope도 확인
Search Console 데이터를 조회만 하는 플러그인이라면 일반적으로 필요한 권한은 Search Console 읽기 권한입니다.
https://www.googleapis.com/auth/webmasters.readonly
사이트 데이터를 수정할 필요가 없는 SEO 분석 도구라면 가능한 한 필요한 최소 권한만 요청하는 편이 좋습니다. 다만 실제 요청 Scope는 사용 중인 플러그인 코드에서 요청하는 권한과 맞아야 합니다.
최종적으로 플러그인에 넣는 3가지 값
| 번호 | 입력 항목 | 가져오는 곳 |
|---|---|---|
| 1 | Google OAuth Client ID | Google Cloud |
| 2 | Google OAuth Client Secret | Google Cloud |
| 3 | Search Console 속성값 | Google Search Console |
Google Search Console OAuth 전체 과정 한 장 정리
설정 순서를 한 번에 보면 아래와 같습니다. 처음에는 복잡해 보이지만 실제로는 Google Cloud에서 OAuth 인증정보 2개를 만들고, Search Console 속성 하나를 입력하는 과정이라고 보면 이해하기 쉽습니다.
연결 후 어떤 데이터를 가져올 수 있을까?
OAuth 연결이 정상적으로 완료되면 플러그인의 구현 방식에 따라 Search Console에 저장된 검색 성과 데이터를 활용할 수 있습니다.
실제로 Google에서 어떤 검색어로 유입되는지 확인
검색 결과에서 실제 클릭된 횟수 확인
검색 결과에 페이지가 노출된 횟수
노출 대비 클릭 비율 확인
검색결과 평균 순위 분석
플러그인 지원 시 색인 상태 판단에 활용
이런 데이터를 AI 분석이나 SEO 자동 점검 기능과 연결하면 단순히 글 안의 키워드만 분석하는 것보다 실제로 Google 검색에서 성과가 있는 페이지를 기준으로 판단할 수 있다는 장점이 있습니다.
Google Search Console OAuth 연결 FAQ
정리
Google Search Console API 연결은 처음 접하면 Client ID, Secret, OAuth, Redirect URI 같은 단어 때문에 상당히 복잡해 보입니다.
하지만 실제 작업 순서를 정리하면 Search Console API 활성화 → OAuth 동의 화면 설정 → OAuth 웹 클라이언트 생성 → Redirect URI 등록 → Client ID/Secret 입력 → Search Console 속성값 입력 순서입니다.
특히 Google 로그인 과정에서 400 redirect_uri_mismatch가 나온다면 무작정 Client ID를 다시 만들기보다 승인된 리디렉션 URI부터 정확하게 비교하는 것이 가장 빠릅니다.
- Search Console API 활성화
- OAuth 동의 화면 설정
- 웹 애플리케이션 OAuth Client 생성
- Redirect URI 정확히 등록
- Client ID 입력
- Client Secret 입력
- Search Console 속성 형식 확인
- Google 계정 인증 후 연결 완료
'IT 오류해결 > 윈도우·명령어' 카테고리의 다른 글
| 텔넷(Telnet) 설치와 포트 점검 장애 분리까지 쓰는 전문가용 정리 (0) | 2026.06.07 |
|---|---|
| MS-DOS 윈도우 XP 설치하는 방법, WINNT 명령어부터 가상머신 세팅까지 정리 (0) | 2026.03.26 |
| 설치 없이 폴더 용량 리스트 만들기 탐색기 대신 PowerShell/du 명령어 확인 (0) | 2026.02.09 |
댓글