Google 애널리틱스 API의 공식 공지사항을 확인하려면 Google 애널리틱스 API 알림 그룹을 구독하세요.
2023년 12월 15일 이제 모든 Google 애널리틱스 속성에서 데이터 액세스 보고서를 사용할 수 있습니다.
이제 모든 Google 애널리틱스 속성(표준 및 Google 애널리틱스 360 고객)에서 데이터 액세스 보고서 기능의 특정 필드를 사용할 수 있습니다.
자세한 내용은 스키마 문서를 참조하세요.
2023년 12월 15일 데이터 액세스 보고서 스키마에 accessDateHour
측정기준이 추가되었습니다.
데이터 액세스 보고서 스키마에 추가된 accessDateHour
측정기준 GA 보고 데이터에 액세스한 GA 사용자의 날짜 시간이 포함됩니다.
2023년 10월 5일 첫 번째 클릭, 선형, 시간 가치 하락, 시점 기반 기여 분석 모델이 포함된 속성은 기본적으로 교차 채널 데이터 기반 기여 분석 모델을 사용합니다.
2023년 10월 중순부터 첫 번째 클릭, 선형, 시간 가치 하락, 위치 기반 기여 분석 모델을 모든 속성의 UpdateAttributionSettings 메서드와 함께 사용할 수 없습니다.
속성이 현재 이러한 모델 중 하나를 사용하도록 구성된 경우 교차 채널 데이터 기반 기여 분석으로 변경됩니다. 교차 채널 마지막 클릭 또는 Google Ads 우선 마지막 클릭을 대신 사용할 수도 있습니다.
2023년 9월 1일 SKAdNetwork 전환 가치 스키마 구성 방법이 추가되었습니다.
GetSKAdNetworkConversionValueSchema
,
CreateSKAdNetworkConversionValueSchema
,
DeleteSKAdNetworkConversionValueSchema
,
UpdateSKAdNetworkConversionValueSchema
,
ListSKAdNetworkConversionValueSchemas
메서드가 Admin API v1alpha에 추가되었습니다.
이 기능을 사용하면 iOS 스트림의 SKAdNetwork 전환 가치 스키마 구성을 관리할 수 있습니다.
2023년 9월 1일 UpdateConversionEvent
메서드를 추가했습니다.
UpdateConversionEvent
메서드가 Admin API v1beta에 추가되었습니다.
2023년 9월 1일 BigQueryLink.enterprise_export_enabled
필드의 이름이 fresh_daily_export_enabled
로 변경되었습니다.
BigQueryLink
리소스의 enterprise_export_enabled
필드 이름이 fresh_daily_export_enabled
로 바뀌었습니다.
2023년 7월 14일 properties.updateAttributionSettings
, properties.getAttributionSettings
메서드에 관한 브레이킹 체인지
2023년 7월 24일부터 Admin API v1 알파에 브레이킹 체인지가 적용되며 이 변경사항은 properties.getAttributionSettings, properties.updateAttributionSettings 메서드의 기능에 영향을 미칩니다.
ReportingAttributionModel
enum의 멤버는 다음과 같이 이름이 변경됩니다.
이전 이름 | 새 이름 |
---|---|
CROSS_CHANNEL_DATA_DRIVEN |
PAID_AND_ORGANIC_CHANNELS_DATA_DRIVEN |
CROSS_CHANNEL_LAST_CLICK |
PAID_AND_ORGANIC_CHANNELS_LAST_CLICK |
CROSS_CHANNEL_FIRST_CLICK |
PAID_AND_ORGANIC_CHANNELS_FIRST_CLICK |
CROSS_CHANNEL_LINEAR |
PAID_AND_ORGANIC_CHANNELS_LINEAR |
CROSS_CHANNEL_POSITION_BASED |
PAID_AND_ORGANIC_CHANNELS_POSITION_BASED |
CROSS_CHANNEL_TIME_DECAY |
PAID_AND_ORGANIC_CHANNELS_TIME_DECAY |
ADS_PREFERRED_LAST_CLICK |
GOOGLE_PAID_CHANNELS_LAST_CLICK |
AdsWebConversionDataExportScope
enum의 멤버는 다음과 같이 이름이 변경됩니다.
이전 이름 | 새 이름 |
---|---|
CROSS_CHANNEL |
PAID_AND_ORGANIC_CHANNELS |
ADS_PREFERRED |
GOOGLE_PAID_CHANNELS |
2023년 7월 10일 AttributionSettings
유형에 ads_web_conversion_data_export_scope
필드 추가
UpdateAttributionSettings
메서드를 사용하여 수정할 수 있는 AttributionSettings
유형에 ads_web_conversion_data_export_scope
필드를 추가했습니다.
2023년 6월 5일 첫 번째 클릭, 선형, 시간 가치 하락, 시점 기반 기여 분석 모델의 지원 중단
2023년 6월부터 UpdateAttributionSettings 메서드를 사용하여 첫 번째 클릭, 선형, 시간 가치 하락, 위치 기반 기여 분석 모델로 GA4 속성을 구성할 수 없습니다. 2023년 9월부터 이러한 모델을 모든 속성에서 사용할 수 없게 됩니다.
자세한 내용은 Google 애널리틱스 제품 공지를 참조하세요.
2023년 5월 31일 애드센스 링크 관리 방법이 추가되었습니다.
GetAdSenseLink
, CreateAdSenseLink
, DeleteAdSenseLink
, ListAdSenseLinks
메서드가 Admin API v1alpha에 추가되었습니다.
이 기능을 사용하면 GA4 속성의 애드센스와 애널리틱스 간의 연결을 관리할 수 있습니다.
2023년 5월 31일 연결된 GA4 속성을 조회하는 메서드가 추가됨
Admin API v1alpha에 추가된 FetchConnectedGa4Property
메서드
이 기능을 사용하면 GA4 이전 프로세스 중에 유니버설 애널리틱스 속성에 연결된 GA4 속성에 관한 정보를 가져올 수 있습니다.
2023년 5월 31일 이벤트 생성 규칙을 관리하는 메서드를 추가했습니다.
CreateEventCreateRule
,
UpdateEventCreateRule
,
DeleteEventCreateRule
,
ListEventCreateRules
,
GetEventCreateRule
메서드가 Admin API v1alpha에 추가되었습니다.
이 기능을 사용하면 소스 이벤트의 일치 기준에 따라 완전히 새로운 이벤트 생성을 트리거할 수 있는 이벤트 생성 규칙을 관리할 수 있습니다.
2023년 5월 31일 맞춤 채널 그룹을 관리하는 메서드를 추가했습니다.
Admin API v1alpha에 GetChannelGroup
, ListChannelGroups
, CreateChannelGroup
, UpdateChannelGroup
, DeleteChannelGroup
메서드를 추가했습니다.
이 기능을 사용하면 웹사이트 트래픽 소스의 맞춤 채널 그룹을 관리할 수 있습니다.
만든 맞춤 채널 그룹은 Google Analytics Data API v1을 사용하여 쿼리할 수 있습니다.
2023년 3월 31일 향상된 측정 설정 관리 메서드를 추가했습니다.
properties.dataStreams.updateEnhancedMeasurementSettings
, properties.dataStreams.getEnhancedMeasurementSettings
메서드가 Admin API v1alpha에 추가되었습니다.
이 기능을 사용하면 GA4 속성의 웹 데이터 스트림에 대한 향상된 측정 설정을 관리할 수 있습니다.
2023-03-31 연결된 사이트 태그 관리 방법을 추가했습니다.
properties.createConnectedSiteTag
, properties.deleteConnectedSiteTag
, properties.listConnectedSiteTags
메서드가 Admin API v1alpha에 추가되었습니다.
이 기능을 사용하면 연결된 사이트 태그를 관리할 수 있으며 유니버설 애널리틱스 속성에서 Google 애널리틱스 4 속성으로 트래픽을 전달하는 데 유용합니다.
2023년 3월 31일 Admin API v1beta에 계정 및 속성 수준 runAccessReport
메서드를 추가했습니다.
properties.runAccessReport
및 accounts.runAccessReport
메서드가 Admin API의 v1beta 버전에 추가되었습니다. 메서드는 맞춤설정된 데이터 액세스 레코드 보고서를 반환합니다.
2023년 2월 24일 확장 데이터 세트 관리 메서드를 추가했습니다.
ExpandedDataSet
리소스가 해당 properties.expandedDataSets.create
, properties.expandedDataSets.delete
, properties.expandedDataSets.patch
, properties.expandedDataSets.list
, properties.expandedDataSets.get
작업과 함께 API의 v1alpha 버전에 추가되었습니다. 이 기능은 Google 애널리틱스 360에서 확장 데이터 세트를 관리하는 데 사용할 수 있습니다.
2023년 2월 24일 사용자 권한 관리를 위해 사용자 링크를 대체하는 액세스 결합
AccessBinding
리소스가 다음 작업과 함께 v1alpha 버전의 API에 추가되었습니다.
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
이 기능을 사용하면 GA4 계정 또는 속성의 사용자 권한을 관리할 수 있으므로 사용자 링크 대신 사용해야 합니다.
2023년 6월 1일에 Admin API v1 알파에서 사용자 링크 기능이 삭제됩니다.
2023년 2월 24일 사용자 권한 감사 메서드 지원 중단
다음 메서드는 지원 중단되었으며 2023년 6월 1일에 Admin API v1 알파에서 삭제될 예정입니다.
2023년 2월 24일 잠재고객 관리 방법을 추가했습니다.
Audience
리소스가 해당 properties.audience.create
, properties.audience.archive
, properties.audience.patch
, properties.audience.list
, properties.audience.get
작업과 함께 API의 v1alpha 버전에 추가되었습니다.
이 기능을 사용하면 GA4 속성의 잠재고객을 관리할 수 있습니다.
2023년 2월 15일 자동 GA4 설정 프로세스 선택 해제 방법이 추가되었습니다.
properties.setAutomatedGa4ConfigurationOptOut
, properties.fetchAutomatedGa4ConfigurationOptOut
작업이 API의 v1alpha 버전에 추가되었습니다.
이 기능을 사용하면 UA 속성의 자동 GA4 설정 프로세스의 선택 해제 상태를 관리할 수 있습니다.
2023년 2월 15일 BigQuery 링크 관리 방법을 추가했습니다.
BigQueryLink
리소스가 해당 properties.bigQueryLinks.get
, properties.bigQueryLinks.list
작업과 함께 API의 v1alpha 버전에 추가되었습니다.
이 기능을 사용하면 GA4 속성과 BigQuery 프로젝트 간 연결에 대한 정보를 검색할 수 있습니다.
2023년 2월 15일 Search Ads 360 링크 관리 방법이 추가되었습니다.
SearchAds360Link
리소스가 해당 properties.searchAds360Links.create
, properties.searchAds360Links.delete
, properties.searchAds360Links.patch
, properties.searchAds360Links.list
, properties.searchAds360Links.get
작업과 함께 API의 v1alpha 버전에 추가되었습니다.
이 기능을 사용하면 GA4 속성과 Search Ads 360 항목 간의 연결을 관리할 수 있습니다.
2023년 2월 15일 브레이킹 체인지.
LESS_THAN_OR_EQUAL
,GREATER_THAN_OR_EQUAL
값이NumericFilter.Operation
enum에서 삭제되었습니다.PARTIAL_REGEXP
값이StringFilter.MatchType
enum에서 삭제되었습니다.
2023-02-15 기타 변경사항.
tokensPerProjectPerHour
필드가AccessQuota
유형에 추가되었습니다.EXPANDED_DATA_SET
,CHANNEL_GROUP
값이ChangeHistoryResourceType
enum에 추가되었습니다.searchAds360Link
,expandedDataSet
,bigqueryLink
값이ChangeHistoryResource
에 추가되었습니다.
2022년 8월 11일 runAccessReport
메서드가 Admin API v1alpha에 추가되었습니다.
properties.runAccessReport
메서드가 Admin API의 v1alpha 버전에 추가되었습니다. 데이터 액세스 레코드의 맞춤 보고서를 반환합니다. 이 보고서는 사용자가 Google 애널리틱스 보고 데이터를 읽을 때마다 기록을 제공합니다. Google 애널리틱스 360 속성의 관리자는 데이터 액세스 보고서를 사용할 수 있습니다.
2022년 7월 11일 Admin API v1베타 버전이 출시되었습니다.
Google 애널리틱스 Admin API의 v1beta 버전이 출시되었습니다.
API의 알파 채널과 베타 채널 모두 Admin API에서 계속 지원됩니다. 베타 채널에는 알파 버전에서 사용할 수 있는 기능의 하위 집합이 포함되어 있으며, 이러한 기능은 안정적이고 향후 큰 변화가 없을 것으로 예상됩니다. 새로운 기능은 기능이 개발되면 베타에 추가될 예정입니다.
2021년 10월 12일 API에서 EnhancedMeasurementSettings 메서드가 삭제됨
properties.webDataStreams.getEnhancedMeasurementSettings
,properties.webDataStreams.updateEnhancedMeasurementSettings
메서드가 API에서 삭제되지만 향상된 측정 설정은 곧 API를 통해 다시 수정할 수 있습니다.UserLink
리소스의directRoles
필드는 더 이상predefinedRoles/manage-users
역할을 지원하지 않습니다. 대신 새predefinedRoles/admin
역할을 사용해야 하며, 이는 이전predefinedRoles/edit
및predefinedRoles/manage-users
역할의 조합과 동일합니다. 이 변경사항은accounts.userLinks
및properties.userLinks
메서드의 동작에 영향을 미치며 Google 애널리틱스에 도입된 액세스 및 데이터 제한 관리 변경사항과 일치합니다.
2021-06-05 기능이 추가되었습니다.
다음 기능이 API에 추가되었습니다.
accounts.searchChangeHistoryEvents
메서드가 API에 추가되었습니다. 이 메서드는 지정된 필터 집합을 기준으로 계정 또는 하위 계정의 모든 변경사항을 검색합니다. 일반적인 원인으로는 Google 애널리틱스 UI를 업데이트하거나 고객 지원팀에서 변경했거나 Google 애널리틱스 시스템이 자동으로 변경되었을 수 있습니다.properties.webDataStreams.measurementProtocolSecrets
에 추가된 측정 프로토콜 보안 비밀 관리 메서드:properties.conversionEvents
에 추가된 전환 이벤트 관리 메서드:properties.customDimensions
에 추가된 맞춤 측정기준 관리 메서드:properties.customMetrics
에 추가된 커스텀 측정항목 관리 메서드:- Google 애널리틱스 4 속성의 Google 신호 데이터 설정을 제어할 수 있는
properties.getGoogleSignalsSettings
,properties.updateGoogleSignalsSettings
메서드가 추가되었습니다. delete_time
,expire_time
는Property
유형에 추가된 필드만 출력합니다.
2021년 6월 5일 브레이킹 체인지.
다음과 같은 브레이킹 체인지가 도입되었습니다.
properties.iosAppDataStreams.create
,properties.androidAppDataStreams.create
메서드가 API에서 삭제되었습니다. Firebase를 사용하여 Google 애널리틱스 4 속성에서 애플리케이션 스트림을 만드세요.properties.delete
메서드는 이제 빈 응답을 반환하는 대신 삭제된 속성 데이터를Property
유형으로 반환합니다.- 이제
Property
유형의time_zone
필드가 필요합니다. deleted
필드가Property
유형에서 삭제되었습니다.UserLink
유형의email_address
필드는 이제 변경할 수 없습니다.UserLink
유형의name
필드는 이제 출력 전용입니다.
2021년 1월 28일 ListFirebaseLinks
작업에 페이지로 나누기 지원이 추가되었습니다.
2021년 1월 28일 브레이킹 체인지.
브레이킹 체인지: update_mask
필드는 모든 업데이트 작업에 필수입니다.
Account
에서country_code
필드의 이름이region_code
로 변경되었습니다.EnhancedMeasurementSettings
에서url_query_parameter
필드의 이름이uri_query_parameter
로 변경되었습니다.parent
입력란이GoogleAdsLink
에서 삭제되었습니다.
2020년 10월 20일 계정 요약 지원을 추가했습니다.
계정 요약 메서드에 대한 지원이 추가되었습니다.
2020년 10월 13일 앱 + 웹 속성의 이름이 Google 애널리틱스 4 (GA4)로 변경됨
2020년 8월 15일 Management App + Web API의 이름이 Admin API로 변경됨
Google 애널리틱스 관리 앱 + 웹 API의 이름이 Google 애널리틱스 Admin API로 변경되었습니다. 따라서 API 엔드포인트가 analyticsadmin.googleapis.com으로 변경되었습니다. 이전 버전의 API 엔드포인트 URL과 클라이언트 라이브러리에 대해 작성된 기존 코드도 이에 따라 업데이트해야 합니다.