변경 기록

Google Analytics API 공식 발표를 확인하려면 Google Analytics API 알림 그룹을 구독하세요.

2026-04-14 GetUserProvidedDataSettings 메서드 추가됨

2025-08-20 GetReportingIdentitySettings 메서드 추가됨

속성의 ReportingIdentitySettings 를 가져올 수 있는 GetReportingIdentitySettings 메서드가 Admin API v1alpha에 추가되었습니다.

2025-08-20 기존 유니버설 애널리틱스 메서드 삭제됨

다음 기존 유니버설 애널리틱스 (UA) 메서드가 Admin API v1alpha에서 삭제되었습니다. SetAutomatedGa4ConfigurationOptOut, FetchAutomatedGa4ConfigurationOptOut, CreateConnectedSiteTag, DeleteConnectedSiteTag, ListConnectedSiteTags, FetchConnectedGa4Property

2025-06-12 하위 속성 동기화 구성 관리 메서드 추가됨

Admin API v1alpha를 사용하여 SubpropertySyncConfig 리소스를 관리하기 위한 GetSubpropertySyncConfig, ListSubpropertySyncConfig, 및 UpdateSubpropertySyncConfig 메서드가 추가되었습니다.

2025-04-16 보고 데이터 주석 관리 메서드 추가됨

Admin API v1alpha를 사용하여 ReportingDataAnnotation 리소스를 관리하기 위한 CreateReportingDataAnnotation, GetReportingDataAnnotation, ListReportingDataAnnotations, UpdateReportingDataAnnotation 및 DeleteReportingDataAnnotation 메서드가 추가되었습니다.

주석을 사용하면 사용자 가 Google 애널리틱스 보고서에 직접 메모를 추가하여 더 쉽게 이벤트 를 기록하거나, 데이터 변경사항을 설명하거나, 나와 팀의 주요 관찰사항을 강조할 수 있습니다.

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 보고서 액세스 설문조사 양식

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

CreateBigQueryLink, UpdateBigQueryLink, 및 DeleteBigQueryLink 메서드가 BigQueryLink 리소스를 Admin API v1alpha를 사용하여 관리하기 위해 추가되었습니다.

BigQueryLink 리소스에 dataset_location 필드가 추가되었습니다.

`ChangeHistoryResourceType`의 새 `BIGQUERY_LINK value in ` 값 아래 변경 내역에 BigQuery 연결 변경사항이 추가되었습니다.

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

맞춤 메서드 가이드라인에 맞게 Admin API v1alpha에서 createSubproperty 맞춤 메서드의 이름이 provisionSubproperty 으로 변경되었습니다.

2024-08-01 이벤트 수정 규칙 관리 추가됨

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

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

2024-08-01 기타 변경사항

Audience 리소스에 create_time이 추가되었습니다.

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

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

2024-05-06 주요 이벤트 관리 메서드 추가됨

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

API 통합을 수정하여 ConversionEvent 대신 KeyEvent를 사용하세요. 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 전환 가치 스키마 구성 메서드 추가됨

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

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

2023-09-01 UpdateConversionEvent 메서드 추가됨

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

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 alpha에 브레이킹 체인지가 적용되어 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 ads_web_conversion_data_export_scope 필드가 AttributionSettings 유형에 추가됨

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

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

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

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

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

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

2023-05-31 연결된 GA4 속성을 조회하는 메서드 추가됨

FetchConnectedGa4Property 메서드가 Admin API v1alpha에 추가되었습니다.

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

2023-05-31 이벤트 생성 규칙을 관리하는 메서드 추가됨

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

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

2023-05-31 맞춤 채널 그룹을 관리하는 메서드 추가됨

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

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

맞춤 채널 그룹을 만든 후에는 Google Analytics Data API v1을 사용하여 쿼리할 수 있습니다.

2023-03-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-03-31 계정 및 속성 수준 runAccessReport 메서드가 Admin API v1beta에 추가됨

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

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 alpha에서 삭제됩니다.

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

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

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 기타 변경사항

2022-08-11 runAccessReport 메서드가 Admin API v1alpha에 추가됨

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

2022-07-11 Admin API v1beta 버전 출시됨

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

API의 알파 및 베타 채널은 Admin API에서 계속 지원됩니다. 베타 채널에는 알파에서 사용할 수 있는 기능 중 안정적인 것으로 간주되며 향후 크게 변경되지 않을 것으로 예상되는 기능의 하위 집합이 포함되어 있습니다. 새로운 기능은 성숙해지면 베타에 추가됩니다.

2021-10-12 EnhancedMeasurementSettings 메서드가 API에서 삭제됨

  • properties.webDataStreams.getEnhancedMeasurementSettings, properties.webDataStreams.updateEnhancedMeasurementSettings 메서드가 API에서 삭제되었지만 향상된 측정 설정은 곧 API를 통해 다시 수정할 수 있게 됩니다.
  • directRoles 리소스의 UserLink 필드는 더 이상 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 측정 프로토콜 비밀번호를 업데이트합니다.
  • properties.conversionEvents: 아래에 전환 이벤트 관리 메서드가 추가되었습니다.
    • create 지정된 속성으로 전환 이벤트를 만듭니다.
    • delete 속성에서 전환 이벤트를 삭제합니다.
    • get 단일 전환 이벤트를 가져옵니다.
    • list 지정된 상위 속성의 전환 이벤트 목록을 반환합니다.
  • properties.customDimensions: 아래에 맞춤 측정기준 관리 메서드가 추가되었습니다.
    • archive 속성의 맞춤 측정기준을 보관처리합니다.
    • create 맞춤 측정기준을 만듭니다.
    • get 단일 맞춤 측정기준을 조회합니다.
    • list 속성의 맞춤 측정기준을 나열합니다.
    • patch 속성의 맞춤 측정기준을 업데이트합니다.
  • `properties.customMetrics` 아래에 맞춤 측정항목 관리 메서드가 추가되었습니다. 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 유형으로 반환합니다.
  • time_zone 유형의 Property 필드가 이제 필수입니다.
  • deleted 필드가 Property 유형에서 삭제되었습니다.
  • email_address 유형의 UserLink 필드를 이제 변경할 수 없습니다.
  • name 유형의 UserLink 필드는 이제 출력 전용입니다.

2021-01-28 브레이킹 체인지

브레이킹 체인지: - update_mask 필드가 모든 업데이트 작업에 필수입니다.

  • Account에서 country_code 필드의 이름이 region_code로 변경되었습니다.

  • EnhancedMeasurementSettings에서 url_query_parameter 필드의 이름이 uri_query_parameter로 변경되었습니다.

  • GoogleAdsLink에서 parent 필드가 삭제되었습니다.

2020-10-20 계정 요약 지원 추가됨

계정 요약 메서드 지원이 추가되었습니다.

2020-10-13 앱 + 웹 속성의 이름이 Google 애널리틱스 4 (GA4)로 변경됨

2020-08-15 Management 앱 + 웹 API의 이름이 Admin API로 변경됨

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