Google 서비스 계정 설정

Google 서비스 계정을 생성하고, Search Console 및 Analytics API를 활성화한 후, JSON 키를 1MarketingTool에 연결하세요.

개인 Google 계정으로 로그인하지 않고 1MarketingTool이 Search Console 및 GA4 데이터를 읽도록 하려면 Google 서비스 계정을 사용하세요.

빠른 Cloud Shell 흐름을 선택하거나, 수동 Google Cloud Console 워크스루를 따를 수 있습니다.

Cloud Shell로 빠른 설정

Cloud Shell은 브라우저에서 실행되며, 이미 Google 계정으로 로그인되어 있습니다. Cloud Shell을 열고, 스크립트를 붙여넣고, Enter를 누르면 완료 시 key.json이 다운로드됩니다. 그런 다음 1MarketingTool에서 JSON 가져오기를 사용하여 다운로드한 키를 불러오고 저장하세요.

set -e
PROJECT_ID=$(gcloud config get-value project 2>/dev/null)
if [ -z "$PROJECT_ID" ]; then
  PROJECT_ID="marketing-tool-$RANDOM$RANDOM"
  gcloud projects create "$PROJECT_ID" --set-as-default
fi
gcloud services enable iam.googleapis.com searchconsole.googleapis.com analyticsadmin.googleapis.com \
  analyticsdata.googleapis.com indexing.googleapis.com --project "$PROJECT_ID"
SA_EMAIL="marketing-tool@$PROJECT_ID.iam.gserviceaccount.com"
gcloud iam service-accounts create marketing-tool --display-name "1MarketingTool" --project "$PROJECT_ID" || true
echo "Waiting for the service account to be ready..."
for i in $(seq 1 30); do
  gcloud iam service-accounts describe "$SA_EMAIL" --project "$PROJECT_ID" >/dev/null 2>&1 && break
  sleep 2
done
rm -f key.json
gcloud iam service-accounts keys create key.json --iam-account "$SA_EMAIL" --project "$PROJECT_ID"
cloudshell download key.json
echo "Grant read access in Search Console and GA4 to: $SA_EMAIL"

1. Google Cloud 프로젝트 생성

Google Cloud Console을 열고, 상단 바의 프로젝트 드롭다운을 사용한 다음 새 프로젝트를 선택하세요. 이미 이 워크스페이스용 프로젝트가 있는 경우 기존 프로젝트를 재사용할 수도 있습니다.

프로젝트에 marketing-tool과 같이 알아보기 쉬운 이름을 지정한 다음 만들기를 클릭하세요.

계속하기 전에 상단 바에서 새 프로젝트가 선택되어 있는지 확인하세요.

2. 서비스 계정 생성

API 및 서비스 -> 사용자 인증 정보로 이동한 다음 사용자 인증 정보 만들기 -> 서비스 계정을 선택하세요.

marketing-tool-reader와 같은 이름을 입력하세요. Google은 해당 이름에서 서비스 계정 ID와 이메일 주소를 생성합니다. 만들고 계속하기를 클릭하세요.

Google Cloud 프로젝트 역할 부여는 건너뛸 수 있습니다. Search Console 및 GA4 접근 권한은 나중에 해당 제품 내에서 부여됩니다. 완료를 클릭하세요.

서비스 계정 이메일을 복사하세요. [email protected]과 같은 형식입니다. 이 이메일은 Search Console 및 Analytics 접근 권한을 부여할 때 사용합니다.

3. JSON 키 다운로드

서비스 계정을 열고 키 탭으로 전환한 다음 키 추가 -> 새 키 만들기를 선택하세요.

JSON을 선택한 다음 만들기를 클릭하세요. .json 파일이 컴퓨터에 다운로드됩니다. 이 파일은 자격 증명이므로 비공개로 보관하세요.

4. 필요한 API 활성화

Google Cloud Console에서 API 및 서비스 -> 라이브러리를 열고 Google Search Console API를 검색하세요.

Google Search Console API를 선택하세요.

선택한 프로젝트에 대해 사용을 클릭하세요.

API 라이브러리로 돌아가 Google Analytics Data API를 검색한 다음 사용 설정하세요. 이 API는 GA4 리포팅에 필요합니다.

선택적으로 Google Analytics Admin API도 사용 설정할 수 있습니다. 이를 통해 연결된 워크플로에서 지원되는 경우 앱이 GA4 속성을 나열할 수 있습니다.

5. Search Console에서 접근 권한 부여

Google Search Console을 열고, 연결하려는 속성을 선택한 다음 설정 -> 사용자 및 권한 -> 사용자 추가로 이동하세요.

2단계의 서비스 계정 이메일을 붙여넣으세요. 전체 또는 제한됨 권한을 선택한 다음 추가를 클릭하세요.

6. Google Analytics에서 접근 권한 부여

Google Analytics를 열고, 관리를 클릭한 다음 올바른 GA4 속성을 선택하세요.

속성 접근 관리로 이동하여 **+**를 클릭하고 서비스 계정 이메일을 추가하세요. 뷰어 또는 분석가 접근 권한을 사용한 다음 추가를 클릭하세요.

7. 1MarketingTool에서 연결

1MarketingTool에서 Google 제공업체 또는 통합 설정을 열고 이전에 다운로드한 JSON 키 파일을 가져오세요.

저장 후, 앱에서 Search Console 또는 GA4 속성을 올바른 프로젝트에 매핑하세요.

참고 사항

Search Console 또는 GA4 데이터가 즉시 표시되지 않으면 잠시 기다린 후 다시 시도하세요. Google 권한 전파에 몇 분 정도 걸릴 수 있습니다.
하나의 서비스 계정을 필요한 만큼 많은 Search Console 및 GA4 속성에 추가한 다음, 1MarketingTool에서 프로젝트별로 매핑할 수 있습니다.
Google Cloud에서 JSON 키를 순환하거나 삭제한 경우 앱에서 새 키를 가져오세요.
JSON 키를 안전하게 보관하고 소스 관리에 커밋하지 마세요.