GSC 사이트 관리 가이드

Google Search Console에 등록된 사이트를 GIIP 플랫폼에서 통합 관리하는 방법을 안내합니다.

🏢 GSC 사이트 관리 페이지로 이동 →

📋 개요

GSC 사이트 관리는 Google Search Console에 등록된 사이트(도메인/URL-prefix)를 GIIP에서 직접 관리할 수 있는 기능입니다. 각 사이트에 Google Cloud 서비스계정 JSON 키를 등록하면, GIIP가 Search Console 데이터를 자동으로 조회합니다.

🔍 주요 용어

용어	설명
GSC 사이트	Google Search Console에 등록된 사이트입니다. `sc-domain:` 접두사(도메인 확인용) 또는 일반 URL(`https://...`) 형식으로 등록합니다.
라벨	사이트를 구분하기 위한 사용자 정의 이름입니다. 예: "마케팅 사이트", "블로그"
서비스계정 키(JSON)	Google Cloud에서 생성한 서비스계정의 JSON 키 파일 내용입니다. Search Console 데이터 조회 권한을 부여합니다.
활성/비활성	해당 GSC 사이트의 상태입니다. 비활성 상태의 사이트는 데이터 조회에서 제외됩니다.
키 상태	서비스계정 키가 등록되어 있는지 여부입니다. "등록됨"이면 GIIP가 해당 사이트의 Search Console 데이터를 조회할 수 있습니다.

🛠️ 관리 방법

1. GSC 사이트 등록

GIIP 좌측 메뉴에서 [인프라 관리] > [GSC 사이트 관리] 로 이동합니다.
GSC 사이트 입력란에 Google Search Console에 등록된 사이트 주소를 입력합니다.
- 도메인 확인 방식(sc-domain:)을 사용 중인 경우: sc-domain:example.com 형식으로 입력
- URL 접두사 방식의 경우: https://www.example.com/ 형식으로 입력
- ⚠️ URL 접두사 방식은 맨 끝 슬래시(/)까지 한 글자도 틀리지 않게 입력해야 합니다. Search Console은 https://example.com(슬래시 없음)과 https://example.com/(슬래시 있음)을 서로 다른 속성으로 취급합니다. 슬래시 하나 때문에 권한을 올바르게 부여했는데도 수집이 계속 403 Forbidden으로 실패하는 경우가 실제로 가장 흔한 원인입니다. 정확한 값은 Search Console 좌측 속성 선택 드롭다운에 표시된 문자열을 그대로 복사하세요.
라벨 입력란에 사이트를 구분할 이름을 입력합니다. 예: "마케팅 사이트"
GSC 서비스계정 키(JSON) 입력창에 Google Cloud 서비스계정 JSON 키 파일의 내용을 붙여넣습니다.
- 기존 키를 유지하고 싶으면 해당 필드를 비워두세요.
- 키가 이미 등록된 상태에서 새 키로 교체하려면, 새 JSON 내용을 붙여넣고 [수정]을 클릭하세요.
- ⚠️ 키를 저장하는 것만으로는 데이터가 수집되지 않습니다. 아래 "서비스계정에 Search Console 접근 권한 부여하기"까지 반드시 완료하세요.
[추가] 버튼을 클릭하여 저장합니다.

🔑 서비스계정에 Search Console 접근 권한 부여하기 (필수)

GA4와 Search Console은 서로 다른 Google 서비스라 권한도 각각 따로 부여해야 합니다. 같은 서비스계정 키를 GA4에 이미 쓰고 있더라도, Search Console 쪽에 별도로 사용자 추가를 해주지 않으면 수집이 계속 403 Forbidden으로 실패합니다.

업로드한 JSON 키 파일을 열어 client_email 값을 확인합니다. (예: xxxx@your-project.iam.gserviceaccount.com)
Google Search Console에 사이트 소유자 계정으로 로그인합니다.
좌측에서 등록하려는 속성(사이트)을 선택합니다.
좌측 하단 설정(⚙️) → 사용자 및 권한으로 이동합니다.
사용자 추가를 클릭하고, 1번에서 확인한 client_email 값을 이메일 주소란에 붙여넣습니다.
권한 수준은 전체(Full)(또는 그 이상)로 지정하고 저장합니다.
완료 후 최대 하루(자동 배치 주기) 내에 데이터가 수집됩니다. 즉시 확인하려면 GA/GSC 수집 파이프라인 페이지의 GSC 섹션에서 [수집 개시] 버튼을 사용하세요.

💡 GA4 서비스계정 키를 그대로 재사용하는 경우가 많은데, 이 경우 GA4 속성 액세스 관리와 Search Console 사용자 및 권한 양쪽에 각각 권한을 부여해야 두 파이프라인이 모두 정상 동작합니다.

2. GSC 사이트 수정

목록에서 수정할 사이트 행을 찾습니다.
해당 행의 [수정] 버튼을 클릭합니다.
입력 폼에 수정할 값(라벨, 키 등)을 변경합니다.
[수정] 버튼을 다시 클릭하여 저장합니다.
수정을 취소하려면 [취소] 버튼을 클릭합니다.

3. GSC 사이트 삭제

목록에서 삭제할 사이트 행을 찾습니다.
해당 행의 [삭제] 버튼을 클릭합니다.
확인 대화상자에서 확인을 클릭합니다.

4. 키 상태 확인

목록의 키 상태 열에서 각 사이트의 키 등록 여부를 확인할 수 있습니다.
등록됨(초록 배지): 서비스계정 키가 등록되어 있어 Search Console 데이터 조회가 가능합니다.
미등록(회색 배지): 키가 없어 현재 데이터가 조회되지 않습니다. 키를 등록하려면 [수정]에서 JSON 키를 붙여넣으세요.

💡 활용 팁

복수 사이트 관리: 여러 도메인/서브도메인을 하나의 GIIP 조직(CSN)에서 모두 관리할 수 있습니다. 라벨을 활용하면 구분하기 쉽습니다.
키 관리: Google Cloud Console에서 서비스계정 키의 만료일을 관리하고, 정기적으로 갱신해 주세요. 키가 만료되면 "키 상태"가 "미등록"으로 변경됩니다.
도메인 vs URL-prefix: Google Search Console에서 sc-domain: 방식(도메인 전체 확인)은 서브도메인 전체를 포함하지만, URL-prefix 방식은 특정 경로만 포함합니다. 필요한 범위에 맞게 선택하세요.

문제 해결

증상	원인	해결
"선택된 조직(CSN)이 없습니다" 오류가 표시됨	로그인한 사용자에게 조직(CSN)이 할당되지 않음	GIIP 관리자에게 연락하여 조직 할당을 요청하세요.
저장 시 "올바른 JSON 형식이 아닙니다" 오류	JSON 키 필드에 잘못된 형식의 내용이 입력됨	Google Cloud Console에서 서비스계정 JSON 키 파일을 다시 다운로드하여, 그 내용을 그대로 붙여넣으세요.
목록에 등록한 사이트가 표시되지 않음	Search Console에 해당 사이트가 등록되어 있지 않거나 권한이 없음	먼저 Google Search Console(https://search.google.com/search-console)에서 사이트 소유권을 확인하세요.
키 상태가 "미등록"으로 표시됨	서비스계정 키를 입력하지 않았거나 키가 만료됨	[수정]을 클릭하여 유효한 서비스계정 JSON 키를 붙여넣으세요.
수집 파이프라인에 "403 (Forbidden)" 오류가 표시됨	키는 등록됐지만 그 서비스계정이 Search Console 쪽 사용자로는 추가되지 않음(GA4 권한과 별개)	위 "서비스계정에 Search Console 접근 권한 부여하기" 절차대로 해당 속성에 서비스계정을 사용자로 추가하세요.
Search Console에 서비스계정을 Full 권한으로 정확히 추가했는데도 계속 "403 (Forbidden)"	GSC 사이트 필드에 입력한 URL이 실제 검증된 속성과 끝 슬래시(`/`) 유무가 다름 (예: 등록값 `https://example.com` vs 실제 속성 `https://example.com/`) — Search Console은 이 둘을 다른 속성으로 취급해 403을 냄	Search Console 좌측 속성 드롭다운에 표시된 정확한 문자열(슬래시 포함 여부까지)을 그대로 복사해 GSC 사이트 필드를 [수정]으로 다시 저장하세요.
"이 조직에 대한 권한이 없습니다" 오류	현재 로그인한 사용자에게 해당 CSN에 대한 권한이 없음	조직 관리자에게 권한 부여를 요청하세요.

버전: 1.0 최종 업데이트: 2026-08-05 소스 파일: giipv3/public/help/gsc-property.ko.md

← PreviousGA Collection Pipeline Guide Next →Project Memo List Guide