Google 애널리틱스 Admin API 개요

요약: 이 문서에서는 Google 애널리틱스 Admin API 버전 1.0을 개략적으로 설명합니다.

경고: API의 초기 미리보기 버전이며 변경될 수 있습니다. 예정된 변경사항을 알려드리려고 하지만 API가 공개적으로 출시되기 전에는 브레이킹 체인지가 발생할 수 있습니다.

API의 알파 및 베타 채널 모두 계속 지원됩니다. 베타 채널에는 알파로 제공되는 기능 중 하위 집합이 포함되어 있으며 안정적인 기능으로 간주되며 향후 크게 변경되지 않을 것으로 예상됩니다. 새로운 기능이 개발되면 베타에 추가됩니다.

Google Analytics API 공식 발표를 확인하려면 Google Analytics API 알림 그룹을 구독하세요. API 관련 문제를 신고하려면 Google 애널리틱스 API 테스터 의견 양식을 사용하세요.

소개

Google 애널리틱스 Admin API를 사용하면 Google 애널리틱스 4 (GA4) 구성 데이터에 프로그래매틱 방식으로 액세스할 수 있으며 GA4 속성과만 호환됩니다. GA4 속성에 대해 자세히 알아보기

Google 애널리틱스 Admin API를 사용하여 다음을 수행할 수 있습니다.

• 새 계정을 프로비저닝합니다.
• 계정 관리.
• 데이터 공유 설정 관리
• 계정 요약을 표시합니다.
• 변경 내역 이벤트 검색
• 속성 관리.
• 사용자 데이터 수집 확인하기
• 속성의 데이터 보관 설정 관리
• 속성의 Google 신호 데이터 설정 관리 (알파)
• 스트림 관리.
• 측정 프로토콜 보안 비밀을 관리합니다.
• 웹 데이터 스트림용 Google 태그 스니펫 생성 (알파)
• 전환 이벤트 관리
• 맞춤 측정기준을 관리합니다.
• 맞춤 측정항목 관리
• GA4 속성과 Firebase 프로젝트 간의 연결을 관리합니다.
• GA4 속성과 Google Ads 계정 간의 연결을 관리합니다.
• GA4 속성과 Display & Video 360 광고주 (알파) 간 연결을 위한 제안서 관리
• GA4 속성과 Display & Video 360 광고주 (알파) 간의 연결을 관리합니다.
• GA4 속성과 Search Ads 360 (알파) 간의 연결을 관리합니다.
• GA4 속성과 BigQuery 프로젝트 (알파) 간의 연결을 관리합니다.
• 계정 계층 구조 및 GA4 속성 (알파)의 사용자 권한을 관리합니다.
• 데이터 액세스 보고서 생성 (알파)
• 잠재고객 관리 (알파)
• 확장 데이터 세트 관리 (알파)
• 자동 GA4 설정 과정 선택 해제 설정 (알파) 관리

사용 가능한 메서드

계정 프로비저닝

• accounts.provisionAccountTicket

  이 메서드는 서비스 약관 (TOS) URL에 포함되어야 하는 accountTicketId 필드를 반환합니다. https://analytics.google.com/analytics/web/?provisioningSignup=false#/termsofservice/ACCOUNT_TICKET_ID 사용자가 TOS URL을 방문하여 서비스 약관에 동의하면 Google 애널리틱스 계정 생성이 완료됩니다(계정 프로비저닝 샘플).

계정 관리

• accounts.delete
• accounts.get
• accounts.list
• accounts.patch

데이터 공유 설정 관리

• accounts.getDataSharingSettings

계정 요약 나열

• accountSummaries.list

변경 내역 검색

• accounts.searchChangeHistoryEvents

속성 관리

• properties.get
• properties.patch
• properties.delete
• properties.list
• properties.create

사용자 데이터 수집 확인

• properties.acknowledgeUserDataCollection

데이터 보관 설정 관리

• properties.getDataRetentionSettings
• properties.updateDataRetentionSettings

Google 신호 데이터 설정 관리 (알파)

• properties.getGoogleSignalsSettings
• properties.updateGoogleSignalsSettings

데이터 스트림 관리

• properties.dataStreams.create
• properties.dataStreams.get
• properties.dataStreams.list
• properties.dataStreams.patch
• properties.dataStreams.delete

측정 프로토콜 보안 비밀 관리

• properties.dataStreams.measurementProtocolSecrets.create
• properties.dataStreams.measurementProtocolSecrets.get
• properties.dataStreams.measurementProtocolSecrets.patch
• properties.dataStreams.measurementProtocolSecrets.list
• properties.dataStreams.measurementProtocolSecrets.delete

전환 이벤트 관리

• properties.conversionEvents.create
• properties.conversionEvents.get
• properties.conversionEvents.list
• properties.conversionEvents.delete

맞춤 측정기준 관리

• properties.customDimensions.create
• properties.customDimensions.get
• properties.customDimensions.list
• properties.customDimensions.patch
• properties.customDimensions.archive

커스텀 측정항목 관리

• properties.customMetrics.create
• properties.customMetrics.get
• properties.customMetrics.list
• properties.customMetrics.patch
• properties.customMetrics.archive

Firebase 프로젝트 연결

• properties.firebaseLinks.create
• properties.firebaseLinks.list
• properties.firebaseLinks.delete

Google Ads 계정 연결

• properties.googleAdsLinks.create
• properties.googleAdsLinks.list
• properties.googleAdsLinks.patch
• properties.googleAdsLinks.delete

Google 태그 생성 (알파)

• properties.webDataStreams.getGlobalSiteTag

GA4 속성과 Display & Video 360 광고주 간 연결을 위한 제안서 (알파)

• properties.displayVideo360AdvertiserLinkProposals.create
• properties.displayVideo360AdvertiserLinkProposals.approve
• properties.displayVideo360AdvertiserLinkProposals.cancel
• properties.displayVideo360AdvertiserLinkProposals.list
• properties.displayVideo360AdvertiserLinkProposals.get
• properties.displayVideo360AdvertiserLinkProposals.delete

Display & Video 360 광고주 계정 연결 (알파)

• properties.displayVideo360AdvertiserLinks.create
• properties.displayVideo360AdvertiserLinks.get
• properties.displayVideo360AdvertiserLinks.list
• properties.displayVideo360AdvertiserLinks.delete
• properties.displayVideo360AdvertiserLinks.patch

Search Ads 360 계정 연결 (알파)

• properties.searchAds360Links.create
• properties.searchAds360Links.delete
• properties.searchAds360Links.patch
• properties.searchAds360Links.list
• properties.searchAds360Links.get

GA4 속성의 애널리틱스 Search Ads 360 통합 설정에 대해 자세히 알아보기

BigQuery 계정 연결 (알파)

• properties.bigQueryLinks.get
• properties.bigQueryLinks.list

GA4 속성의 BigQuery 내보내기 설정 자세히 알아보기

사용자 권한 관리 (알파)

• accounts.accessBindings.create
• accounts.accessBindings.delete
• accounts.accessBindings.patch
• accounts.accessBindings.list
• accounts.accessBindings.get
• accounts.accessBindings.batchCreate
• accounts.accessBindings.batchDelete
• accounts.accessBindings.batchUpdate
• accounts.accessBindings.batchGet
• properties.accessBindings.create
• properties.accessBindings.delete
• properties.accessBindings.patch
• properties.accessBindings.list
• properties.accessBindings.get
• properties.accessBindings.batchCreate
• properties.accessBindings.batchDelete
• properties.accessBindings.batchUpdate
• properties.accessBindings.batchGet

데이터 액세스 보고서 (알파)

• properties.runAccessReport

이 기능에 대한 자세한 내용은 데이터 액세스 보고서 가이드를 참조하세요.

잠재고객 관리 (알파)

• properties.audiences.create
• properties.audiences.archive
• properties.audiences.patch
• properties.audiences.list
• properties.audiences.get

Google 애널리틱스의 잠재고객에 대해 자세히 알아보세요.

확장된 데이터 세트 관리 (알파)

• properties.expandedDataSets.create
• properties.expandedDataSets.delete
• properties.expandedDataSets.patch
• properties.expandedDataSets.list
• properties.expandedDataSets.get

Google 애널리틱스 360의 확장된 데이터 세트에 대해 자세히 알아보기

자동 GA4 설정 프로세스 선택 해제 (알파)

• properties.setAutomatedGa4ConfigurationOptOut
• properties.fetchAutomatedGa4ConfigurationOptOut

UA 속성의 자동 GA4 설정 프로세스에서 선택 해제 상태를 관리하는 방법 자세히 알아보기