변경 기록

Google 애널리틱스 API 공식 발표를 확인하려면 Google 애널리틱스 API 알림 그룹을 구독하세요.

2025-03-07 sharingWithGoogleAnySalesEnabled 매개변수 지원 중단

이제 getDataSharingSettings 메서드의 sharingWithGoogleAnySalesEnabled 매개변수가 지원 중단되며 항상 false을 반환합니다. 이 필드는 2025년 6월에 Google 애널리틱스 Admin API v1beta에서 삭제됩니다.

2025-01-20 DataRetentionSettings에 사용자 데이터 보관이 추가됨

Admin API v1alpha 및 v1beta의 DataRetentionSettings에 userDataRetention 필드를 추가했습니다. 이 필드를 사용하여 사용자 데이터의 보관 설정을 검색하거나 수정합니다.

2024-09-09 액세스 보고서 설문조사 양식

runAccessReport 메서드 문서에 Google 애널리틱스 액세스 보고서 의견 양식 링크가 포함되도록 업데이트되었습니다. Google은 여러분의 의견을 소중하게 생각하며 이 API를 더욱 개선하는 데 도움이 되도록 의견을 공유해 주시기 바랍니다.

Admin API v1alpha로 BigQueryLink 리소스를 관리하기 위한 CreateBigQueryLink, UpdateBigQueryLink, DeleteBigQueryLink 메서드를 추가했습니다.

BigQueryLink 리소스에 dataset_location 필드를 추가했습니다.

ChangeHistoryResourceType의 새 BIGQUERY_LINK 값 아래 변경 내역에 BigQuery 링크 변경사항을 추가했습니다.

2024-08-01 createSubproperty 메서드의 브레이킹 체인지

커스텀 메서드 가이드라인에 따라 Admin API v1alpha에서 createSubproperty 커스텀 메서드의 이름을 provisionSubproperty로 변경했습니다.

2024-08-01 이벤트 수정 규칙 관리가 추가되었습니다.

Admin API v1alpha에 GetEventEditRule, CreateEventEditRule, DeleteEventEditRule, ListEventEditRules, UpdateEventEditRules, ReorderEventEditRules 메서드가 추가되었습니다.

EventEditRule는 소스 이벤트의 일치하는 기준에 따라 완전히 새 이벤트 생성을 트리거하는 조건을 정의합니다. 또한 EventEditRule는 소스 이벤트의 매개변수 수정을 정의할 수 있습니다.

2024-08-01 기타 변경사항

Audience 리소스에 create_time를 추가했습니다.

채널 그룹이 보고서의 기본 채널 그룹인지 나타내기 위해 ChannelGroup 리소스에 primary를 추가했습니다. 한 번에 하나의 채널 그룹만 primary를 true로 설정할 수 있습니다. 채널 그룹의 primary를 true로 설정하면 이전 기본 채널 그룹의 primary가 자동으로 false로 설정됩니다.

계정이 GMP 조직에 연결된 경우 Google Marketing Platform 조직 리소스의 URI가 포함된 Account 리소스에 gmp_organization를 추가했습니다.

2024-05-06 주요 이벤트 관리 메서드가 추가되었습니다.

이제 주요 이벤트의 리소스와 메서드를 사용할 수 있습니다.

ConversionEvent 대신 KeyEvent를 사용하도록 API 통합을 수정합니다. ConversionEvent가 지원 중단되었습니다.

2023-12-15 이제 모든 Google 애널리틱스 속성에서 데이터 액세스 보고서를 사용할 수 있습니다.

이제 표준 및 Google 애널리틱스 360 고객 모두 모든 Google 애널리틱스 속성에서 데이터 액세스 보고서 기능의 특정 필드를 사용할 수 있습니다.

자세한 내용은 스키마 문서를 참고하세요.

2023-12-15 데이터 액세스 보고서 스키마에 accessDateHour 측정기준이 추가되었습니다.

accessDateHour 측정기준이 데이터 액세스 보고서 스키마에 추가되었습니다. GA 보고 데이터에 액세스한 GA 사용자의 날짜 시간입니다.

2023-10-05 첫 번째 클릭, 선형, 시간 가치 하락, 시점 기반 기여 분석 모델이 적용된 속성은 교차 채널 DDA를 기본값으로 사용합니다.

2023년 10월 중순부터 모든 속성에서 첫 번째 클릭, 선형, 시간 가치 하락, 시점 기간 기여 분석 모델을 UpdateAttributionSettings 메서드와 함께 사용할 수 없습니다.

현재 속성이 이러한 모델 중 하나를 사용하도록 구성된 경우 교차 채널 데이터 기반 기여 분석으로 변경됩니다. 교차 채널 마지막 클릭 또는 Google Ads 우선 마지막 클릭을 대신 사용할 수도 있습니다.

2023-09-01 SKAdNetwork 전환 가치 스키마 구성 메서드를 추가했습니다.

Admin API v1alpha에 GetSKAdNetworkConversionValueSchema, CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema, ListSKAdNetworkConversionValueSchemas 메서드가 추가되었습니다.

이 기능을 사용하면 iOS 스트림의 SKAdNetwork 전환 가치 스키마 구성을 관리할 수 있습니다.

2023-09-01 UpdateConversionEvent 메서드가 추가되었습니다.

Admin API v1beta에 UpdateConversionEvent 메서드가 추가되었습니다.

2023-09-01 BigQueryLink.enterprise_export_enabled 필드의 이름이 fresh_daily_export_enabled로 변경되었습니다.

BigQueryLink 리소스의 enterprise_export_enabled 필드 이름이 fresh_daily_export_enabled로 바뀌었습니다.

2023-07-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-07-10 AttributionSettings 유형에 ads_web_conversion_data_export_scope 필드가 추가되었습니다.

UpdateAttributionSettings 메서드를 사용하여 수정할 수 있는 ads_web_conversion_data_export_scope 필드를 AttributionSettings 유형에 추가했습니다.

2023-06-05 첫 번째 클릭, 선형, 시간 가치 하락, 시점 기반 기여 분석 모델이 지원 중단되었습니다.

2023년 6월부터 UpdateAttributionSettings 메서드를 사용하여 첫 번째 클릭, 선형, 시간 가치 하락, 시점 기반 기여 분석 모델로 GA4 속성을 구성할 수 없습니다. 2023년 9월부터는 모든 속성에서 이러한 모델을 사용할 수 없게 됩니다.

자세한 내용은 Google 애널리틱스 제품 공지사항을 참고하세요.

Admin API v1alpha에 GetAdSenseLink, CreateAdSenseLink, DeleteAdSenseLink, ListAdSenseLinks 메서드가 추가되었습니다.

이 기능을 사용하면 GA4 속성의 애드센스-애널리틱스 연결을 관리할 수 있습니다.

2023-05-31 연결된 GA4 속성을 조회하는 메서드를 추가했습니다.

Admin API v1alpha에 FetchConnectedGa4Property 메서드가 추가됨

이 기능을 사용하면 GA4 이전 프로세스 중에 유니버설 애널리틱스 속성에 연결된 GA4 속성에 관한 정보를 얻을 수 있습니다.

2023-05-31 이벤트 생성 규칙을 관리하는 메서드를 추가했습니다.

Admin API v1alpha에 CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules, GetEventCreateRule 메서드가 추가되었습니다.

이 기능을 사용하면 소스 이벤트의 일치하는 기준에 따라 완전히 새로운 이벤트 생성을 트리거할 수 있는 이벤트 생성 규칙을 관리할 수 있습니다.

2023-05-31 맞춤 채널 그룹을 관리하는 메서드를 추가했습니다.

Admin API v1alpha에 GetChannelGroup, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup, DeleteChannelGroup 메서드를 추가했습니다.

이 기능을 사용하면 웹사이트 트래픽 소스의 맞춤 채널 그룹을 관리할 수 있습니다.

맞춤 채널 그룹을 만들면 Google 애널리틱스 Data API v1을 사용하여 쿼리할 수 있습니다.

2023-03-31 향상된 측정 설정 관리 메서드를 추가했습니다.

properties.dataStreams.updateEnhancedMeasurementSettings, properties.dataStreams.getEnhancedMeasurementSettings 메서드가 Admin API v1alpha에 추가되었습니다.

이 기능을 사용하면 GA4 속성의 웹 데이터 스트림에 대한 향상된 측정 설정을 관리할 수 있습니다.

2023-03-31 연결된 사이트 태그 관리 메서드를 추가했습니다.

Admin API v1alpha에 properties.createConnectedSiteTag, properties.deleteConnectedSiteTag, properties.listConnectedSiteTags 메서드가 추가되었습니다.

이 기능을 사용하면 연결된 사이트 태그를 관리할 수 있으며 유니버설 애널리틱스 속성에서 Google 애널리틱스 4 속성으로 트래픽을 전달하는 데 유용합니다.

2023-03-31 Admin API v1beta에 계정 및 속성 수준 runAccessReport 메서드가 추가되었습니다.

Admin API의 v1beta 버전에 properties.runAccessReport 및 accounts.runAccessReport 메서드가 추가되었습니다. 메서드는 맞춤설정된 데이터 액세스 기록 보고서를 반환합니다.

2023-02-24 확장 데이터 세트 관리 메서드를 추가했습니다.

ExpandedDataSet 리소스가 상응하는 properties.expandedDataSets.create, properties.expandedDataSets.delete, properties.expandedDataSets.patch, properties.expandedDataSets.list, properties.expandedDataSets.get 작업과 함께 API의 v1alpha 버전에 추가되었습니다. 이 기능은 Google 애널리틱스 360에서 확장 데이터 세트를 관리하는 데 사용할 수 있습니다.

AccessBinding 리소스가 다음 작업과 함께 API의 v1alpha 버전에 추가되었습니다.

이 기능을 사용하면 GA4 계정 또는 속성의 사용자 권한을 관리할 수 있으며 사용자 링크 대신 사용해야 합니다.

사용자 연결 기능이 2023년 6월 1일부터 Admin API v1 알파에서 삭제됩니다.

2023-02-24 사용자 권한 감사 메서드 지원 중단

다음 메서드는 지원 중단되었으며 2023년 6월 1일부터 Admin API v1 알파에서 삭제됩니다.

2023-02-24 잠재고객 관리 메서드가 추가되었습니다.

Audience 리소스가 상응하는 properties.audience.create, properties.audience.archive, properties.audience.patch, properties.audience.list, properties.audience.get 작업과 함께 API의 v1alpha 버전에 추가되었습니다.

이 기능을 사용하면 GA4 속성의 잠재고객을 관리할 수 있습니다.

2023-02-15 자동 GA4 설정 프로세스 선택 해제 방법을 추가했습니다.

properties.setAutomatedGa4ConfigurationOptOut, properties.fetchAutomatedGa4ConfigurationOptOut 작업이 API의 v1alpha 버전에 추가되었습니다.

이 기능을 사용하면 UA 속성의 자동 GA4 설정 프로세스 선택 해제 상태를 관리할 수 있습니다.

BigQueryLink 리소스가 상응하는 properties.bigQueryLinks.get, properties.bigQueryLinks.list 작업과 함께 API의 v1alpha 버전에 추가되었습니다.

이 기능을 사용하면 GA4 속성과 BigQuery 프로젝트 간의 연결에 관한 정보를 검색할 수 있습니다.

SearchAds360Link 리소스가 상응하는 properties.searchAds360Links.create, properties.searchAds360Links.delete, properties.searchAds360Links.patch, properties.searchAds360Links.list, properties.searchAds360Links.get 작업과 함께 API의 v1alpha 버전에 추가되었습니다.

이 기능을 사용하면 GA4 속성과 Search Ads 360 항목 간의 연결을 관리할 수 있습니다.

2023-02-15 브레이킹 체인지

2023-02-15 기타 변경사항

  • tokensPerProjectPerHour 필드가 AccessQuota 유형에 추가되었습니다.
  • EXPANDED_DATA_SET, CHANNEL_GROUP 값이 ChangeHistoryResourceType 열거형에 추가되었습니다.
  • searchAds360Link, expandedDataSet, bigqueryLink 값이 ChangeHistoryResource에 추가되었습니다.

2022-08-11 Admin API v1alpha에 runAccessReport 메서드가 추가되었습니다.

Admin API의 v1alpha 버전에 properties.runAccessReport 메서드가 추가되었습니다. 데이터 액세스 레코드의 맞춤설정된 보고서를 반환합니다. 이 보고서에는 사용자가 Google 애널리틱스 보고 데이터를 읽을 때마다 기록이 제공됩니다. 데이터 액세스 보고서는 Google 애널리틱스 360 속성의 관리자가 사용할 수 있습니다.

2022-07-11 Admin API v1beta 버전이 출시되었습니다.

Google 애널리틱스 Admin API의 v1beta 버전이 출시되었습니다.

Admin API의 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에 측정 프로토콜 비밀번호 관리 메서드가 추가되었습니다.
    • create 측정 프로토콜 보안 비밀을 만듭니다.
    • delete 대상 측정 프로토콜 보안 비밀을 삭제합니다.
    • get 단일 측정 프로토콜 비밀을 조회합니다.
    • list 지정된 상위 속성 아래의 하위 측정 프로토콜 비밀번호를 반환합니다.
    • patch measuring protocol secret을 업데이트합니다.
  • properties.conversionEvents에 전환 이벤트 관리 메서드가 추가되었습니다.
    • create 지정된 속성으로 전환 이벤트를 만듭니다.
    • delete 속성에서 전환 이벤트를 삭제합니다.
    • get 단일 전환 이벤트를 검색합니다.
    • list 지정된 상위 속성의 전환 이벤트 목록을 반환합니다.
  • properties.customDimensions에 맞춤 측정기준 관리 메서드가 추가되었습니다.
    • archive 속성의 맞춤 측정기준을 보관처리합니다.
    • create 맞춤 측정기준을 만듭니다.
    • get 단일 맞춤 측정기준을 조회합니다.
    • list 속성의 맞춤 측정기준을 나열합니다.
    • patch 속성의 맞춤 측정기준을 업데이트합니다.
  • properties.customMetrics에 맞춤 측정항목 관리 메서드가 추가되었습니다.
    • archive 속성의 맞춤 측정항목을 보관처리합니다.
    • create맞춤 측정항목을 만듭니다.
    • get 단일 맞춤 측정항목을 조회합니다.
    • list 속성의 맞춤 측정항목을 표시합니다.
    • patch 속성의 맞춤 측정항목을 업데이트합니다.
  • Google 애널리틱스 4 속성의 Google 신호 설정을 제어할 수 있는 properties.getGoogleSignalsSettings, properties.updateGoogleSignalsSettings 메서드를 추가했습니다.
  • delete_time, expire_time: Property 유형에 추가된 필드만 출력합니다.

2021-06-05 브레이킹 체인지

다음과 같은 중대한 변경사항이 도입되었습니다.

  • properties.iosAppDataStreams.create, properties.androidAppDataStreams.create 메서드가 API에서 삭제되었습니다. Firebase를 사용하여 Google 애널리틱스 4 속성에서 애플리케이션 스트림을 만드세요.
  • 이제 properties.delete 메서드는 빈 응답을 반환하는 대신 삭제된 속성 데이터를 Property 유형으로 반환합니다.
  • 이제 Property 유형의 time_zone 필드가 필요합니다.
  • deleted 필드가 Property 유형에서 삭제되었습니다.
  • 이제 UserLink 유형의 email_address 필드는 변경할 수 없습니다.
  • UserLink 유형의 name 필드는 이제 출력 전용입니다.

2021-01-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-08-15 관리 앱 + 웹 API의 이름이 Admin API로 변경되었습니다.

Google 애널리틱스 Management App + Web API의 이름이 Google 애널리틱스 Admin API로 변경되었습니다. 이에 따라 API 엔드포인트가 analyticsadmin.googleapis.com으로 변경되었습니다. 이전 버전의 API 엔드포인트 URL 및 클라이언트 라이브러리에 대해 작성된 기존 코드는 그에 따라 업데이트해야 합니다.