Google 애널리틱스 Admin API 개요

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

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

API의 알파 및 베타 채널 모두 계속 지원됩니다. 베타 채널에는 안정적인 것으로 간주되며 향후 중요한 변화가 없을 것으로 예상되는 알파 버전에서 제공되는 기능의 하위 집합이 포함됩니다. 새로운 기능이 개발되면 베타에 추가될 예정입니다.

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

소개

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

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

• 새 계정 프로비저닝.
• 계정 관리.
• 데이터 공유 설정 관리
• 계정 요약을 나열합니다.
• 변경 내역 이벤트 검색.
• 속성 관리.
• 사용자 데이터 수집을 확인합니다.
• 속성의 데이터 보관 설정 관리
• 속성에 대한 Google 신호 데이터 설정 관리하기 (알파)
• 스트림 관리.
• 측정 프로토콜 보안 비밀을 관리합니다.
• SKAdNetwork 전환 가치 스키마 (알파)를 관리합니다.
• 웹 데이터 스트림용 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

SKAdNetwork 전환 가치 스키마 관리 (알파)

• properties.dataStreams.sKAdNetworkConversionValueSchema.get
• properties.dataStreams.sKAdNetworkConversionValueSchema.create
• properties.dataStreams.sKAdNetworkConversionValueSchema.delete
• properties.dataStreams.sKAdNetworkConversionValueSchema.update
• properties.dataStreams.sKAdNetworkConversionValueSchema.list

전환 이벤트 관리

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

맞춤 측정기준 관리

• 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 Export 설정 자세히 알아보기

사용자 권한 관리 (알파)

• 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 설정 프로세스에서 선택 해제 상태를 관리하는 방법을 자세히 알아보세요.