Google 마케팅 API
Google 애널리틱스(GA4), Search Console, Google Ads, YouTube 데이터를 XBOSS 작업 API 한 곳에서 호출하는 API 입니다.콘솔에서 Google 계정 연동을 마치고 조회할 자산을 고르면 REST 로 연동 상태, 측정 진단, 애널리틱스 리포트, 검색 실적, 색인 상태, 광고 성과, YouTube 분석을 같은 요청 형태로 조회할 수 있고, 이 조회는 모두 AI 도구(MCP)에서도 부를 수 있습니다.데모는 요금제와 상관없이 모든 계정에 같습니다. 정식 환경은 현재 공개 요금제를 시작한 뒤 쓰는 환경입니다. 전체 18개 API 를 모두 POST /v1/jobs 한 경로로 제출하고 작업 아이디로 결과를 받습니다.
이 API 는 Google 계정 연동이 필요합니다. [자격증명 등록]인증서나 기관 아이디·비밀번호가 아니라 Google 동의 화면을 거쳐 연결합니다.콘솔에서 연동을 마치면 account_link_id 가 발급되고, 요청 본문에서 생략하면 등록한 것이 하나뿐일 때만 그것이 자동으로 선택되고, 둘 이상이면 account_link_id 를 넣어야 합니다.Google Ads 와 YouTube 조회에는 기본 연동 권한(애널리틱스, Search Console) 외에 별도 권한이 필요합니다. 권한이 없으면 호출이 실패하고, 콘솔 상품 연동 화면에서 다시 연결해 그 항목을 허용하라는 안내가 옵니다.
API 목록
연동 상태
Google Ads
애널리틱스(GA4)
Search Console
Tag Manager