Google 검색 콘솔을 Excel에 연결하는 방법 - SQL로 SEO 데이터 쿼리하기

Excel에 연결하기 · 검색 콘솔

다음에서 데이터를 가져오세요 검색 콘솔 ~ 안으로 Excel

Google Search Console 계정에서 실시간으로 데이터를 가져와 Excel로 불러오고 원할 때마다 새로 고칠 수 있습니다. ODBC 드라이버, 내보내기, 매크로가 필요 없습니다. 처음 설정하는 데 약 10분 정도 소요되며, 무료 플랜에서 모두 이용 가능합니다.

약 10분 코딩이 필요 없습니다 자격증명은 영구적으로 보관됩니다. 웹에서도 엑셀을 사용할 수 있습니다.

당신이 최종적으로 얻게 될 것

검색 콘솔 계정에 대한 SQL 쿼리의 실시간 결과를 보여주는 워크시트입니다. 데이터가 변경될 때마다 최신 행을 가져오는 버튼도 포함되어 있습니다. 예를 들어 다음과 같습니다.

판매.xlsx — 엑셀

홈끼워 넣다데이터쿼리 스트림

	A	B	C	D	E
1	customer_id	첫 번째 이름	성	국가	총
2	1042	마리아	알바레스	미국	1,284.50
3	1043	다니엘	오카포르	미국	612.00
4	1047	프리야	나이르	미국	2,090.75
5	1051	도마	산	미국	338.20
6	1056	루시아	페레이라	미국	1,455.00
7	1060	켄지	사토	미국	874.10
8

시트1 검색 콘솔에서 실시간으로 전해드립니다.

Google Search Console은 API를 통해 데이터를 관리합니다. 일반적으로 최신 데이터가 필요할 때마다 Search Console 대시보드에서 CSV 파일로 내보내야 Excel로 가져올 수 있습니다. 하지만 Query Streams를 사용하면 이 과정을 생략할 수 있습니다. Agent라는 작은 도우미 프로그램이 데이터가 저장된 위치에서 쿼리를 실행하고, Excel 추가 기능이 필요한 행을 요청합니다. 암호화된 링크를 통해 결과만 전송되므로 Excel 파일은 어디에 있든 상관없습니다. 집의 노트북, 멀리 떨어진 동료의 컴퓨터, 또는 웹 기반 Excel 등 어디에서든 사용할 수 있습니다.

필요한 것

Query Streams 계정

이 가이드를 이용하시려면 무료 플랜으로도 충분합니다. 지금 가입하세요. my.querystreams.com.

항상 켜져 있는 컴퓨터의 에이전트

백그라운드에서 실행되는 작은 프로그램으로, Excel에서 검색 콘솔을 요청할 때 호출합니다. 인터넷 연결만 있으면 됩니다.

검색 콘솔 로그인 정보

검색 콘솔에 한 번 로그인하고 읽기 권한을 허용하면 됩니다. 쿼리 스트림에는 비밀번호를 입력할 필요가 없습니다.

5단계로 연결하세요

1. 계정을 만드세요

   가다 my.querystreams.com 가입하세요. 선택하세요. 무료 정식 플랜입니다. 체험판이 아니며, 검색 콘솔 계정 연결 및 Excel에서 쿼리 실행 기능을 포함합니다.

2. 항상 켜져 있는 컴퓨터에 에이전트를 설치하십시오.

   로그인, 열기 다운로드인터넷에 접속할 수 있는 상시 가동 컴퓨터 또는 서버에 에이전트를 설치하십시오. 설치에는 약 1분 정도 소요되며, 이후에는 자동으로 시작됩니다.

   드라이버 대신 작은 프로그램을 사용하는 이유는 무엇인가요? 에이전트는 Windows, Mac 또는 Linux용으로 한 번만 설치하면 되며(Windows에서는 약 85MB, Mac 및 Linux에서는 100MB 조금 넘는 용량), 백그라운드에서 조용히 실행됩니다. 웹 브라우저와 마찬가지로 쿼리 스트림에 암호화된 연결을 한 번만 생성하므로 방화벽 포트를 열거나 VPN을 설정할 필요가 없습니다. 키는 해당 컴퓨터에 보관되며, 데이터는 필요한 경우 인터넷을 통해 사용자의 위치로 전송됩니다. 사용자가 해야 할 일은 추가 기능 설치뿐입니다.

   다운로드 페이지가 표시됩니다 액세스 키에이전트가 요청할 때 해당 코드를 붙여넣고 배지가 인식될 때까지 기다리세요. 쿼리 스트림에 연결됨에이전트 자체에서 할 수 있는 일은 그게 전부입니다.

   자세한 공략이 필요하시면 보여드리겠습니다. 윈도우, 스코틀랜드 사람, 리눅스.

3. 검색 콘솔 계정을 가리키도록 설정하세요.

   브라우저로 돌아가서 열기 데이터 에이전트 (아래에 데이터 상단 메뉴에서 담당 에이전트를 확인하세요. (상단 메뉴에 있습니다.) 커넥터 추가 그리고 선택하세요 Google 검색 콘솔먼저 검색 콘솔 자격 증명이 필요하신가요? 안내를 열고 다음 정보를 입력하세요.

   Search Console 자격 증명을 생성하세요 (약 15분)

   Google Search Console을 다른 탭에서 열어둔 상태로 다음 단계를 진행하세요. Query Streams는 여기서 생성한 내용을 저장해 상담원이 활용할 수 있도록 하며, Google Search Console에서만 데이터를 읽어옵니다.

   누가 이것을 할 수 있을까요?

   검색 콘솔: 서비스 계정을 사용자로 추가하려면 속성 소유자(인증되었거나 위임받은 사용자)여야 합니다. Google Cloud: 프로젝트 소유자(직접 생성한 모든 프로젝트에 대해 소유자 권한이 부여됨)이거나 해당 프로젝트에 대한 서비스 계정 생성, 서비스 계정 키 관리자 및 서비스 사용 관리자 역할을 보유해야 합니다.

   추천

   Google Cloud 서비스 계정 JSON 키(service_account 형식의 .json 파일)이며, 해당 서비스 계정은 Search Console 속성에 제한된 사용자로 추가되어 있습니다.

   시작하기 전에

   • 귀하의 사이트는 이미 Google 검색 콘솔에 추가 및 인증되었습니다. 새로 등록된 사이트의 경우 Google에서 데이터를 수집하는 데 최대 일주일이 소요될 수 있습니다.
   • 해당 검색 콘솔 속성에 대한 소유자 액세스 권한이 필요합니다. 소유자만 사용자를 추가할 수 있습니다. 전체 사용자 또는 제한된 사용자인 경우 Google Cloud 부분(1~12단계)을 수행하고 소유자에게 13~17단계를 요청하세요.
   • Google Cloud 프로젝트를 생성할 수 있는 Google 계정 또는 관리하는 기존 프로젝트가 필요합니다. 회사 Google Cloud 조직이 2024년 5월 3일 이후에 생성된 경우 Google은 기본적으로 키 다운로드를 차단하므로 Google Cloud 관리자가 키 다운로드를 허용해야 할 수 있습니다(일반적인 문제 참조).
   • 결제 계정이 필요하지 않습니다. Google은 Search Console API 사용에 대해 요금을 부과하지 않습니다.
   • 이미 서비스 계정을 사용하여 Query Streams의 Google Analytics 4 커넥터를 설정하셨나요? 그렇다면 해당 커넥터를 재사용할 수 있습니다. 동일한 프로젝트에서 Search Console API를 활성화한 다음(4단계), 해당 서비스 계정의 이메일을 사용하여 13단계로 진행하세요. 동일한 JSON 키 파일이 두 커넥터 모두에 사용됩니다.
   • 쿼리 스트림 마법사가 새 탭에서 열립니다(데이터 에이전트 → 커넥터 추가 → Google Search Console). 이때 에이전트가 온라인 상태입니다.

   단계

   1. Google 클라우드에서 리소스를 관리하세요

      Google 계정으로 로그인하고 Google Cloud 콘솔의 리소스 관리 페이지를 연 다음 프로젝트 만들기를 클릭하세요.

      이미 사용하려는 Google Cloud 프로젝트(예: Google Analytics 4 커넥터용으로 만든 프로젝트)가 있으신가요? 그렇다면 3단계로 건너뛰어 해당 프로젝트를 선택하세요. Google Cloud를 처음 열 때 Google에서 국가를 선택하고 서비스 약관에 동의하라는 메시지가 표시될 수 있습니다.

   2. 프로젝트 이름을 정하고 생성하세요.

      새 프로젝트 창에서 'Query Streams Search Console'과 같은 프로젝트 이름을 입력합니다. 상위 조직 또는 폴더 상자는 Google에서 자동으로 채워주므로 그대로 둡니다. 조직이 표시되지 않으면 그대로 두어도 됩니다. '만들기'를 클릭합니다.

      프로젝트 이름은 4자에서 30자까지 가능하며, 문자, 숫자, 공백, 하이픈, 작은따옴표, 느낌표를 사용할 수 있습니다. 결제 계정을 선택할 필요는 없습니다.

   3. 프로젝트를 선택하세요

      페이지 상단의 Google Cloud 로고 옆에 있는 프로젝트 선택기를 클릭한 다음 프로젝트 이름을 클릭하세요. 아래의 모든 Google Cloud 단계는 이 프로젝트에서 진행됩니다.

      가장 흔한 실수는 한 프로젝트에서 API를 활성화하고 다른 프로젝트에서 키를 생성하는 것입니다. 각 Google Cloud 단계 전에 페이지 상단의 프로젝트 이름을 확인하세요.

   4. Google 검색 콘솔 API를 활성화하세요

      API 라이브러리에서 Google Search Console API 페이지를 엽니다. 프로젝트 이름이 상단에 표시되는지 확인한 다음 '사용 설정'을 클릭합니다.

      API 및 서비스 → 라이브러리에서 Google Search Console API를 검색하여 해당 API에 접근할 수도 있습니다. Query Streams에서 사용하지 않는 인덱싱 API 또는 사이트 검증 API는 선택하지 마세요. Google에서 API가 이미 사용 설정되어 있다고 표시되면 5단계로 진행하세요. 이 하나의 API로 Query Streams에서 읽는 모든 항목(속성 목록, 사이트맵, 실적 데이터, URL 검사)을 이용할 수 있습니다.

   5. 서비스 계정 생성 페이지를 엽니다.

      서비스 계정 만들기 페이지를 엽니다. Google Cloud 내에서 탐색 메뉴(왼쪽 상단의 세 줄 아이콘)를 열고 IAM 및 관리 → 서비스 계정을 선택한 다음 + 서비스 계정 만들기를 클릭할 수도 있습니다.

      Google Analytics 4 커넥터에서 사용하던 서비스 계정을 재사용하시나요? 두 번째 계정을 만들지 마세요. 해당 프로젝트의 4단계를 완료한 다음, 해당 이메일 주소를 사용하여 13단계로 이동하세요.

   6. 서비스 계정의 이름을 지정하세요

      서비스 계정 이름에 query-streams-gsc를 입력합니다. Google에서 해당 정보를 기반으로 서비스 계정 ID를 자동으로 채워줍니다. 설명은 선택 사항입니다. 만들기를 클릭하고 계속 진행합니다.

      ID는 나중에 변경할 수 없습니다. 서비스 계정의 이메일 주소 앞부분이 됩니다.

   7. 프로젝트 역할은 건너뛰세요.

      다음 섹션에서는 프로젝트 내 역할을 선택할 수 있습니다. 역할 입력란을 비워두고 '계속'을 클릭하세요.

      여기서는 서비스 계정에 소유자, 편집자 또는 뷰어 권한을 부여하지 마세요. 검색 콘솔 데이터에 대한 액세스 권한은 16단계에서 검색 콘솔 내에서 부여됩니다. Google Cloud 역할은 검색 콘솔에서 아무런 역할을 하지 않으며, Google Cloud에서 해당 키가 수행할 수 있는 작업 범위를 확장하는 역할만 합니다.

   8. 서비스 계정 생성을 완료하세요

      마지막 섹션(서비스 계정 사용자 역할 및 서비스 계정 관리자 역할)은 비워두고 완료를 클릭하세요. 그러면 서비스 계정 목록으로 돌아갑니다.

   9. 서비스 계정 이메일을 복사하세요

      목록에서 새 계정을 찾으세요. 해당 계정의 이메일 주소는 [email protected] 형식입니다. 이 주소를 복사하여 16단계에서 사용하세요.

      .iam.gserviceaccount.com을 포함한 전체 주소를 복사하세요. 이 주소는 12단계에서 만든 키 파일의 client_email 줄에도 있습니다. Google에 따르면 새 서비스 계정은 사용 가능해지기까지 1분 이상 걸릴 수 있습니다.

   10. 키 탭을 엽니다

       서비스 계정의 이메일 주소를 클릭한 다음, '키' 탭을 클릭합니다.

   11. 새 키를 시작하세요

       '키 추가'를 클릭한 다음 '새 키 만들기'를 선택하세요.

       '서비스 계정 키 생성이 비활성화됨'이라는 제목의 상자가 나타나면 조직에서 키 다운로드를 차단한 것입니다. 일반적인 문제 해결 방법을 참조하세요.

   12. JSON 키를 다운로드하세요

       키 유형으로 JSON을 선택하고 만들기를 클릭하세요. 브라우저가 .json 파일을 다운로드하며, 일반적으로 다운로드 폴더에 저장됩니다.

       이 다운로드는 한 번만 가능하며, 동일한 파일을 다시 다운로드할 수 없습니다. 파일을 분실한 경우 새 키를 생성하고 이전 키를 삭제하세요. P12 옵션을 선택하지 마세요. 파일을 비공개로 유지하세요. 이메일로 보내거나 공유 폴더에 저장하지 마세요. 파일을 가진 사람은 누구나 이 검색 콘솔 데이터를 읽을 수 있습니다. 쿼리 스트림은 에이전트를 위해 이 데이터를 저장하며, 해당 에이전트를 통해서만 데이터를 읽습니다.

   13. 검색 콘솔을 열고 속성을 선택하세요.

       사이트 소유자로 로그인하여 Google Search Console을 엽니다. 왼쪽 상단의 속성 드롭다운 메뉴에서 쿼리 스트림이 읽을 속성을 선택합니다.

       사이트가 두 번 나열되어 있는 경우, 한 번은 도메인 이름(example.com)으로, 다른 한 번은 주소(https://www.example.com/)로 표시되는 경우, 도메인 이름이 우선합니다. 도메인 이름은 모든 하위 도메인과 http 및 https 프로토콜을 모두 포함하므로 일반적으로 도메인 이름을 선택하는 것이 좋습니다.

   14. 오픈 사용자 및 권한

       왼쪽 메뉴에서 아래로 스크롤하여 설정을 클릭합니다. 그런 다음 사용자 및 권한을 클릭합니다.

       부동산 소유자만 사용자 및 권한을 볼 수 있습니다. 만약 해당 정보가 보이지 않는다면, 귀하는 전체 사용자 또는 제한된 사용자일 가능성이 높습니다. 9단계에서 작성한 이메일을 부동산 소유자에게 보내 13~17단계를 진행하도록 요청하십시오.

   15. 사용자 추가를 클릭하세요

       사용자 및 권한 페이지 오른쪽 상단에 있는 '사용자 추가'를 클릭합니다. '사용자 추가' 상자가 열립니다.

   16. 서비스 계정 이메일을 입력하고 '제한됨'을 선택하세요.

       9단계에서 얻은 서비스 계정 이메일을 이메일 주소 입력란에 붙여넣으세요. 권한 목록을 열고 '제한됨'을 선택하세요.

       제한적 권한이면 충분합니다. Google은 제한적 권한을 가진 사용자에게 실적 보고서를 포함한 모든 보고서를 볼 수 있도록 하고 URL 검사를 사용할 수 있도록 허용합니다. 전체 권한도 마찬가지입니다. 어느 경우든 에이전트는 Google에 읽기 전용 액세스 권한만 요청하므로 사이트맵을 제출하거나 URL을 삭제하거나 설정을 변경할 수 없습니다.

   17. 서비스 계정을 추가하세요

       [추가]를 클릭합니다. 이제 서비스 계정이 제한된 권한으로 속성의 사용자 목록에 표시됩니다.

       검색 콘솔에서 주소를 수락하지 않는 경우(예: 이메일 주소가 Google 계정과 일치하지 않거나 찾을 수 없다는 메시지가 표시되는 경우) 일반적인 문제 해결 방법을 참조하세요. Google은 2026년 4월 이후 새로 생성된 서비스 계정과 관련된 알려진 문제를 겪고 있습니다.

   18. 속성이 어떻게 표기되는지 주목하세요.

       속성 드롭다운 메뉴에서 속성 이름을 확인하세요. example.com과 같은 이름만 있는 경우는 도메인 속성입니다. 이 경우 sc-domain:example.com과 같이 입력합니다. https://www.example.com/과 같은 전체 주소는 URL 접두사 속성입니다. 이 경우 http 또는 https, www 포함 여부, 그리고 끝에 슬래시(/)를 포함하여 표시된 그대로 입력해야 합니다.

       더 쉬운 방법은 쿼리 스트림 마법사의 감지 버튼을 사용하는 것입니다. 속성이 https://www.example.com/인데 https://example.com/을 입력하거나 마지막 슬래시를 생략하면 서비스 계정이 읽을 수 없는 속성을 가리키게 됩니다.

   부여할 권한

   의지	액세스	사용 용도
   검색 콘솔 사용자 권한(설정 → 사용자 및 권한)	제한됨 (전체 버전도 작동합니다)	모든 gsc 테이블(검색 분석(실적 데이터: 날짜, 검색어, 페이지, 국가 및 기기별 클릭, 노출, CTR 및 순위), 사이트 및 사이트맵)은 기본적으로 모두 활성화되어 있으며, URL 검사(기본적으로 비활성화되어 있으며 필요에 따라 실행됨)도 포함됩니다. Google은 제한된 사용자도 모든 보고서를 보고 URL 검사를 사용할 수 있도록 허용합니다.
   Google 클라우드 API: Google 검색 콘솔 API	활성화됨	연결 테스트, 감지 버튼 및 모든 gsc 테이블을 확인하세요. 이것들이 없으면 Google은 모든 통화에 대해 403 오류를 반환합니다.
   OAuth 범위 https://www.googleapis.com/auth/webmasters.readonly	에이전트가 요청했습니다(설정할 사항 없음).	모든 gsc 테이블, 연결 테스트 및 감지. Google은 이 범위를 읽기 전용 액세스라고 설명하므로 에이전트는 사이트맵을 제출하거나 URL을 삭제하거나 설정을 변경할 수 없습니다.
   서비스 계정에 대한 Google Cloud 프로젝트 역할	없음	테이블에는 필요 없습니다. 검색 콘솔 액세스는 위에 명시된 사용자 권한에서만 부여됩니다.
   검색 콘솔 소유자(설정을 수행하는 담당자이며, 서비스 계정이 아님)	소유자(확인됨 또는 위임됨)	테이블 기능이 없습니다. 소유자만 속성에 사용자를 추가할 수 있습니다.

   쿼리 스트림에 붙여넣기

   서비스 계정 JSON 키

   12단계에서 생성된 전체 .json 파일을 업로드합니다. 상자 아래에 있는 "이 컴퓨터에서 업로드"를 클릭하고 파일을 선택합니다(파일이 에이전트 컴퓨터에 있는 경우 "에이전트의 파일에서..."를 선택). 또는 메모장(Mac에서는 TextEdit)에서 파일을 열고 전체를 선택한 다음 복사하여 첫 번째 {부터 마지막 }까지 붙여넣습니다. 나중에 커넥터를 편집할 때 이 상자를 비워 두면 저장된 키가 유지되고, 새 파일을 추가하여 기존 키를 대체할 수 있습니다.

   사이트 속성 URL

   키를 입력한 후 상자 옆의 [감지]를 클릭합니다(에이전트가 온라인 상태여야 합니다). 상자에 서비스 계정이 볼 수 있는 모든 속성 목록(예: sc-domain:example.com — siteRestrictedUser)이 표시됩니다. 원하는 속성을 선택하거나 18단계에서 확인한 대로 직접 입력합니다. 도메인 속성의 경우 sc-domain:example.com을 입력하고, URL 접두사 속성의 경우 마지막에 슬래시를 포함한 전체 주소(예: https://www.example.com/)를 입력합니다.

   흔히 발생하는 문제

   연결 테스트가 '잘못된 키 유형' 오류와 함께 실패했습니다. 'service_account'가 필요합니다.

   왜: 해당 파일은 서비스 계정 키가 아닙니다. 일반적으로 해당 파일은 OAuth 클라이언트 파일(client_secret_….json과 같은 이름)이거나 API 및 서비스 → 자격 증명에서 가져온 API 키입니다.

   고치다: 서비스 계정에 JSON 키를 생성하고(10~12단계 참조) 해당 파일을 사용하십시오. 서비스 계정 키에는 "type": "service_account"라는 줄이 포함되어 있습니다.

   JSON 형식이 잘못되었거나 서비스 계정 키의 'private_key' 필드가 누락되었거나 비어 있다는 오류로 연결 테스트가 실패합니다.

   왜: 파일의 일부만 복사되었거나 복사하는 동안 텍스트가 변경되었습니다.

   고치다: "이 컴퓨터에서 업로드"를 클릭하고 복사하는 대신 .json 파일을 선택하세요. 또는 메모장(Mac에서는 TextEdit)에서 파일을 다시 열고 Ctrl+A(Mac에서는 Cmd+A)를 누른 다음 복사하여 앞뒤에 아무것도 입력하지 않고 붙여넣으세요.

   '…' 서비스 계정에 Search Console 속성이 없거나, 감지 결과에 '아무것도 감지되지 않았습니다'라는 오류와 함께 연결 테스트가 실패합니다.

   왜: Search Console에서 아직 서비스 계정을 어떤 속성에도 추가하지 않았습니다. 13~17단계가 건너뛰어졌거나, 다른 사이트에서 수행되었거나, Search Console에서 이메일 수신을 거부했습니다.

   고치다: 9단계에서 확인한 이메일을 해당 속성의 사용자로 추가합니다(13~17단계). 이제 사용자 및 권한에 표시되는지 확인한 다음 다시 테스트를 클릭합니다.

   서비스 계정 '…'에 대한 액세스 권한이 없습니다. 검색 콘솔 속성에 추가하세요. 라는 오류와 함께 연결 테스트가 실패합니다. 서비스 계정이 사용자 및 권한에 등록되어 있음에도 불구하고 이러한 오류가 발생합니다. 감지 도구는 Google에서 제공하는 다음과 같은 메시지를 표시할 수도 있습니다. "프로젝트 …에서 Google 검색 콘솔 API를 이전에 사용하지 않았거나 비활성화되어 있습니다."

   왜: 키가 속한 Google Cloud 프로젝트(키 파일의 project_id 줄)에서 Google Search Console API가 사용 설정되어 있지 않습니다. Google은 해당 호출을 403 오류로 거부하며, 테스트에서는 이를 액세스 권한 부족으로 보고합니다.

   고치다: Google Cloud에서 해당 프로젝트를 선택하고 Google Search Console API를 사용 설정한 다음(4단계), 몇 분 정도 기다린 후 다시 테스트를 클릭하세요.

   연결 테스트 결과는 연결됨으로 표시되지만 gsc.search_analytics 필드는 비어 있고 에이전트 로그에는 검색 분석 API 오류: 접근 금지됨이 표시됩니다.

   왜: 사이트 속성 URL이 서비스 계정이 추가된 속성과 정확히 일치하지 않습니다. 예를 들어 sc-domain:과 https://, www와 www 없음, http와 https, 또는 마지막 슬래시가 누락된 경우 등이 있습니다. 이 테스트는 서비스 계정이 하나 이상의 속성을 볼 수 있는지 여부만 확인합니다. 동기화는 사용자가 입력한 URL을 읽습니다.

   고치다: 데이터 에이전트에서 커넥터를 열고 편집을 클릭합니다. 사이트 속성 URL 옆의 감지를 클릭하고 목록에서 속성을 선택한 다음 연결 테스트를 클릭하고 변경 사항 저장을 클릭합니다.

   검색 콘솔에서 서비스 계정을 추가할 수 없습니다. 이메일 주소가 Google 계정과 일치하지 않거나, 사용자 추가 실패: 이메일을 찾을 수 없음이라는 메시지가 표시됩니다.

   왜: 알려진 구글 문제: 2026년 4월 말부터 검색 콘솔과 구글 애널리틱스에서 새로 생성된 서비스 계정이 한동안 인식되지 않는 현상이 발생하고 있습니다. 개발자들은 이 문제가 2026년 9월까지 지속되었다고 보고했습니다. 주소에 오타가 있거나 공백이 있는 경우에도 동일한 오류 메시지가 나타납니다.

   고치다: 주소를 공백 없이 다시 붙여넣으세요. 그래도 거부되면 몇 시간 기다렸다가 다시 시도해 보세요. 이전에 생성한 서비스 계정이 있는 경우 일반적으로 작동합니다. (예: Google Analytics 4 커넥터에서 생성한) 서비스 계정이 있다면 해당 계정의 이메일을 입력하고 키 파일을 사용하세요.

   Google Cloud에서 '새 키 만들기'를 클릭하면 서비스 계정 키 생성이 비활성화되어 있다고 표시됩니다.

   왜: 귀 조직은 iam.disableServiceAccountKeyCreation 정책을 시행하고 있습니다. Google은 2024년 5월 3일 이후에 생성된 조직에 대해 이 정책을 기본적으로 활성화합니다.

   고치다: Google Cloud 관리자(조직 정책 관리자 역할을 가진 사용자)에게 이 프로젝트를 정책 적용 대상에서 제외해 달라고 요청하세요. Google은 단일 프로젝트에 대한 태그 기반 예외 처리 방법을 안내하고 있습니다. 그런 다음 11단계와 12단계를 반복하세요.

   이전에는 정상적으로 작동하던 커넥터가 동기화를 중단하고, 연결 테스트 시 "연결 오류: … invalid_grant … 잘못된 JWT 서명" 오류가 발생합니다.

   왜: Google Cloud에서 키가 삭제되었거나, 비활성화되었거나, 만료되었습니다.

   고치다: 새 키를 생성합니다(10~12단계). 데이터 에이전트에서 커넥터를 열고 편집을 클릭한 다음 새 파일을 서비스 계정 JSON 키에 넣고 연결 테스트를 클릭한 후 변경 사항 저장을 클릭합니다. Google Cloud에서 이전 키를 삭제합니다.

   테스트 연결에 실패하며, 오류 메시지에는 invalid_grant 및 Invalid JWT: Token must be a short-lived token이 언급됩니다.

   왜: 에이전트 컴퓨터의 시계가 몇 분 정도 오차가 있습니다. 구글은 시간이 맞지 않는 컴퓨터의 로그인 시도를 거부합니다.

   고치다: 에이전트 컴퓨터에서 자동(인터넷) 시간을 켠 다음 다시 테스트를 클릭하십시오.

   gsc.search_analytics의 클릭수와 노출수를 합산한 값이 Search Console 실적 차트보다 적습니다.

   왜: 구글은 드물게 발생하는 (익명 처리된) 검색어를 행별 결과에서 제외하지만, 차트 합계에는 여전히 이러한 검색어가 포함됩니다. 또한 구글은 각 속성에 대해 검색 유형별로 하루 최대 5만 개의 행만 반환합니다. URL 접두사 속성은 도메인 속성보다 사이트의 더 적은 부분을 나타냅니다.

   고치다: 문제가 있는 것은 아닙니다. 차트 합계가 아닌 검색 콘솔의 표와 행 합계를 비교하고, 전체 사이트를 확인하려면 도메인 속성을 선택하세요.

   gsc.search_analytics에서 최근 2~3일간의 데이터가 누락되었습니다.

   왜: 구글의 데이터는 일반적으로 사건 발생 후 2~3일 후에 준비됩니다. 에이전트는 오늘로부터 최대 3일 전까지의 구글 최종 데이터만 읽습니다.

   고치다: 변경할 사항은 없습니다. 해당 날짜는 이후 동기화에서 반영됩니다. 각 동기화는 최근 5일간의 데이터를 다시 읽어오므로, 최근 변경 사항도 반영됩니다.

   Query Streams가 이 속성을 읽지 않도록 하려면 어떻게 해야 할까요?

   왜: 커넥터를 삭제해도 Google의 액세스 권한은 제거되지 않습니다. 서비스 계정은 사용자 계정으로 유지되고 키도 계속 유효합니다.

   고치다: 검색 콘솔 → 설정 → 사용자 및 권한에서 서비스 계정 옆의 메뉴를 열고 액세스 제거를 클릭합니다. Google Cloud에서 서비스 계정의 키 탭을 열고 키를 삭제합니다. 그런 다음 데이터 에이전트에서 커넥터를 삭제합니다.

   알아야 할 한계

   • 기록: 검색 콘솔에는 최근 16개월간의 데이터가 저장됩니다. 에이전트의 첫 번째 동기화 시에는 16개월 전체 데이터가 읽어오며, 그 이전 날짜의 데이터는 Google에서 제공되지 않습니다.
   • 최신성: Google 데이터는 일반적으로 2~3일 후에 준비됩니다. 에이전트는 오늘로부터 최대 3일 전까지의 최종 데이터만 읽고, 동기화할 때마다 최근 5일간의 데이터를 다시 읽습니다.
   • 행 수: Google은 검색 유형별, 속성별로 하루 최대 5만 개의 행을 클릭 수 순으로 정렬하여 반환합니다. 드물게 발생하는 (익명 처리된) 검색어는 행으로 표시되지 않으므로 행 합계는 검색 콘솔 차트의 총계보다 낮습니다.
   • 검색 유형은 웹, 이미지, 비디오, 뉴스, 디스커버로 나뉘며, 각각 search_type 열에 표시됩니다. 디스커버 행에는 쿼리나 기기 정보가 없습니다. 뉴스 행에도 쿼리 정보가 없습니다.
   • 할당량: 검색 분석은 속성 및 사용자별로 분당 1,200건의 쿼리를 허용하며, Google Cloud 프로젝트별로 분당 40,000건(일일 3천만 건)의 쿼리를 허용합니다. 또한 10분 단위 및 일일 단위로 부하 제한이 적용됩니다. 장기간에 걸쳐 페이지 및 쿼리별로 그룹화된 쿼리는 부하를 가장 많이 발생시키므로, 규모가 매우 큰 사이트의 첫 번째 동기화 시 할당량을 초과할 수 있습니다. 에이전트는 분당 60건의 요청으로 속도를 조절합니다.
   • URL 검사: 하루 2,000건, 분당 600건의 검사가 속성별로 수행됩니다. 따라서 url_inspection 테이블은 기본적으로 비활성화되어 있으며 필요할 때만 실행됩니다.
   • 신규 사이트: 구글은 새로 추가된 사이트에 대한 데이터를 생성하는 데 최대 일주일이 걸릴 수 있습니다.
   • 키: 서비스 계정당 최대 10개의 키를 사용할 수 있습니다. 키는 기본적으로 만료되지 않으며, 조직에서 최대 사용 기간을 설정할 수 있습니다.
   • 사용자: 하나의 부동산에는 소유자가 아닌 사용자를 최대 100명까지 둘 수 있습니다.
   • 비용: Google은 Search Console API 사용에 대해 요금을 부과하지 않습니다.

   2026년 10월 8일 검증 완료. 출처: developers.google.com/webmaster-tools/v1/how-tos/authorizing, developers.google.com/webmaster-tools/v1/prereqs, developers.google.com/webmaster-tools/v1/sites, developers.google.com/webmaster-tools/v1/searchanalytics/…, developers.google.com/webmaster-tools/v1/how-tos/all-your…, developers.google.com/webmaster-tools/limits, developers.google.com/webmaster-tools/pricing, developers.google.com/search/blog/2022/10/performance-dat…, developers.google.com/search/blog/2018/06/new-url-inspect…, developers.google.com/identity/protocols/oauth2/service-a…, docs.cloud.google.com/resource-manager/docs/creating-manager…, docs.cloud.google.com/resource-manager/docs/access-contro…, docs.cloud.google.com/iam/docs/service-accounts-create, docs.cloud.google.com/iam/docs/keys-create-delete, docs.cloud.google.com/iam/docs/troubleshoot-org-policies, support.google.com/googleapi/answer/6158841?hl=en, support.google.com/webmasters/answer/7687615?hl=en, support.google.com/webmasters/answer/34592?hl=en, support.google.com/webmasters/answer/96568?hl=en, support.google.com/analytics/answer/10737381?hl=en, docs.airbyte.com/integrations/sources/google-search-console, help.imaginaire.co.uk/books/seo-tool/page/grant-access-to…, victorious.com/blog/google-search-console-add-user, seotesting.com/google-search-console/domain-vs-url-prefix, discuss.google.dev/t/problem-with-new-service-accounts/36…, piunikaweb.com/2026/05/01/google-service-account-email-no…, sanj.dev/post/google-analytics-search-console-service-acc…, dev.to/morinaga/what-i-learned-debugging-gsc-url-inspecti….

   연결 이름

   나중에 알아볼 수 있는 이름들입니다. 예를 들어, 판매 데이터베이스 같은 것이죠.

   서비스 계정 JSON 키

   검색 콘솔 속성에 사용자로 추가된 Google 서비스 계정의 키 파일 내용을 붙여넣으세요.

   사이트 속성 URL

   검색 콘솔에 표시되는 사이트 주소(예: sc-domain:example.com 또는 https://example.com/)를 정확히 입력해 주세요.

   클릭 테스트 연결읽을 때 연결됨클릭 저장연결은 몇 초 내에 에이전트에 도달합니다.

   오픈 데이터 에이전트

   테스트에 실패했나요? 일반적으로 권한이 누락되었거나 잘못된 검색 콘솔 계정의 자격 증명을 사용했기 때문입니다. 위의 안내에는 해당 내용이 나와 있습니다. 일반적인 문제 그리고 그 해결책들.

4. See your data in Query Builder 선택 과목

   You can look at your Search Console account before Excel is involved at all. Open 쿼리 빌더 in the portal and pick the connection you just made. The 스키마 tab lists your tables and columns, and clicking one puts its name in the editor, so you can write a query without remembering exact names. Click 실행 and the rows appear under 결과. Query Builder is on every plan, Free included.

   On Business plans you can also ask Nova in plain English (“show me customers in the USA”) and it writes the SQL for you. When the query looks right, save it: from Personal Core up it shows in the add-in’s Saved Queries list, and on any plan you can copy the SQL into the next step.

5. Excel에 쿼리 스트림 추가

   엑셀에서 다음으로 이동하세요. 삽입 → 추가 기능 가져오기검색하세요 쿼리 스트림그리고 클릭하세요 추가하다또는 바로 열어보세요. Microsoft AppSource에서 Query Streams를 검색하세요.리본 메뉴에 '스트림 쿼리' 버튼이 나타납니다. 동일한 계정으로 로그인하세요.

   Windows 및 Mac용 Microsoft 365 Excel과 웹 버전 Excel에서 작동합니다.

6. 첫 번째 테이블을 가져오세요

   "쿼리 스트림" 버튼을 클릭하고 선택하세요. 쿼리를 스트리밍하세요그리고 방금 연결한 연결을 선택하세요.

   실행하려는 쿼리를 입력하세요. 이 쿼리는 테이블에서 몇 개의 열을 가져옵니다. gsc.search_analytics 테이블:

   예시 · SQL

   SELECT date, query, clicks, impressions FROM gsc.search_analytics ORDER BY clicks DESC LIMIT 100;

   아래에 목적지 정보 선택하다 새 시트를 만드세요그런 다음 재생 버튼(▶ 화살표)을 누르세요. 1~2초 안에 행이 Excel에 나타납니다. 데이터가 변경될 때마다 재생 버튼을 다시 누르면 시트가 자동으로 업데이트됩니다.

   SQL을 모르시나요? Build it in 쿼리 빌더 first and paste it here, or pick it from Saved Queries if you saved it.

좋은 다음 행보입니다

• 쿼리를 저장하세요 포털에 저장되므로 엑셀이나 구글 시트에서 한 번의 클릭으로 다시 실행할 수 있습니다.
• 필터를 추가하세요 날짜 범위를 지정할 수 있으므로 편집 없이 동일한 쿼리로 "이번 달"이라는 답변을 얻을 수 있습니다.
• 결과를 공유하세요 동료와 함께 있을 때, 그들은 당신의 자격 증명이 아니라 행 목록만 봅니다.

사람들이 묻는 질문

관련 가이드

• Google Search Console에서 Google Sheets로
• Stripe에서 Microsoft Excel로
• HubSpot에서 Microsoft Excel로
• Shopify에서 Microsoft Excel로
• Excel에서 SQL 실행하기
• 모든 가이드