Nhật ký thay đổi

Để xem thông báo chính thức về API Google Analytics, vui lòng đăng ký Nhóm thông báo về API Google Analytics.

20/8/2025 Thêm phương thức GetReportingIdentitySettings

Đã thêm phương thức GetReportingIdentitySettings vào Admin API phiên bản 1 alpha. Phương thức này cho phép bạn truy xuất ReportingIdentitySettings cho một tài sản.

20/08/2025 Xoá các phương thức Universal Analytics cũ

Các phương thức Universal Analytics (UA) cũ sau đây đã bị xoá khỏi Admin API phiên bản 1 alpha: SetAutomatedGa4ConfigurationOptOut, FetchAutomatedGa4ConfigurationOptOut, CreateConnectedSiteTag, DeleteConnectedSiteTag, ListConnectedSiteTags và FetchConnectedGa4Property.

2025-06-12 Thêm các phương thức quản lý cấu hình đồng bộ hoá tài sản phụ

Thêm các phương thức GetSubpropertySyncConfig, ListSubpropertySyncConfig và UpdateSubpropertySyncConfig để quản lý tài nguyên SubpropertySyncConfig bằng Admin API phiên bản 1 alpha.

16/04/2025 Thêm các phương thức quản lý Chú thích dữ liệu báo cáo

Đã thêm các phương thức CreateReportingDataAnnotation, GetReportingDataAnnotation, ListReportingDataAnnotations, UpdateReportingDataAnnotation và DeleteReportingDataAnnotation để quản lý tài nguyên ReportingDataAnnotation bằng Admin API phiên bản 1 alpha.

Chú thích cho phép người dùng trực tiếp thêm ghi chú vào báo cáo của Google Analytics, giúp bạn dễ dàng ghi lại các sự kiện, giải thích những thay đổi về dữ liệu hoặc làm nổi bật những thông tin quan sát chính cho bản thân và nhóm của bạn.

Ngày 7 tháng 3 năm 2025 Ngừng sử dụng tham số sharingWithGoogleAnySalesEnabled

Tham số sharingWithGoogleAnySalesEnabled của phương thức getDataSharingSettings hiện không được dùng nữa và sẽ luôn trả về false. Trường này sẽ bị xoá khỏi Google Analytics Admin API phiên bản 1 beta vào tháng 6 năm 2025.

20/01/2025 Thêm quy định lưu giữ dữ liệu người dùng vào DataRetentionSettings

Thêm trường userDataRetention vào DataRetentionSettings trong Admin API phiên bản 1 alpha và 1 beta. Sử dụng trường này để truy xuất hoặc sửa đổi chế độ cài đặt giữ lại cho dữ liệu người dùng.

09/09/2024 Biểu mẫu khảo sát Báo cáo quyền truy cập

Tài liệu cho phương thức runAccessReport đã được cập nhật để thêm một đường liên kết đến biểu mẫu Ý kiến phản hồi về Báo cáo truy cập Google Analytics. Chúng tôi rất trân trọng ý kiến đóng góp của bạn và khuyến khích bạn chia sẻ ý kiến về API này để giúp chúng tôi cải thiện API hơn nữa.

Thêm các phương thức CreateBigQueryLink, UpdateBigQueryLink và DeleteBigQueryLink để quản lý tài nguyên BigQueryLink bằng Admin API phiên bản 1 alpha.

Đã thêm trường dataset_location vào tài nguyên BigQueryLink.

Đã thêm các thay đổi về mối liên kết với BigQuery vào nhật ký thay đổi trong giá trị BIGQUERY_LINK mới trong ChangeHistoryResourceType.

Ngày 1 tháng 8 năm 2024 Thay đổi có thể gây lỗi đối với phương thức createSubproperty

Đổi tên phương thức tuỳ chỉnh createSubproperty thành provisionSubproperty trong Admin API phiên bản 1 alpha để tuân thủ nguyên tắc về phương thức tuỳ chỉnh.

01/08/2024 Đã thêm tính năng quản lý quy tắc chỉnh sửa sự kiện

GetEventEditRule, CreateEventEditRule, DeleteEventEditRule, ListEventEditRules, UpdateEventEditRules, ReorderEventEditRules, các phương thức được thêm vào Admin API phiên bản 1 alpha.

EventEditRule xác định những điều kiện sẽ kích hoạt việc tạo một sự kiện hoàn toàn mới dựa trên các tiêu chí khớp của một sự kiện nguồn. Ngoài ra, EventEditRule có thể xác định các điểm sửa đổi của tham số từ sự kiện nguồn.

01/08/2024 Các thay đổi khác

Đã thêm create_time vào tài nguyên Audience.

Đã thêm primary vào tài nguyên ChannelGroup để cho biết liệu nhóm kênh có phải là nhóm kênh mặc định cho báo cáo hay không. Tại một thời điểm, chỉ một nhóm kênh có thể đặt primary thành true. Việc đặt primary thành true cho một nhóm kênh sẽ tự động đặt primary thành false cho nhóm kênh chính trước đó.

Đã thêm gmp_organization vào tài nguyên Account. Tài nguyên này chứa URI cho tài nguyên tổ chức Google Marketing Platform nếu tài khoản được kết nối với một tổ chức GMP.

2024-05-06 Thêm các phương thức quản lý sự kiện chính

Hiện đã có các tài nguyên và phương thức cho sự kiện chính.

Sửa đổi chế độ tích hợp API để sử dụng KeyEvent thay vì ConversionEvent. ConversionEvent không được dùng nữa.

15/12/2023 Hiện tại, tất cả tài sản Google Analytics đều có thể sử dụng báo cáo về quyền truy cập vào dữ liệu.

Giờ đây, một số trường của tính năng Báo cáo về quyền truy cập vào dữ liệu đã được cung cấp cho tất cả tài sản Google Analytics, cả khách hàng sử dụng phiên bản Chuẩn và Google Analytics 360.

Hãy xem tài liệu về lược đồ để biết thêm thông tin.

15/12/2023 Phương diện accessDateHour được thêm vào giản đồ Báo cáo về quyền truy cập vào dữ liệu.

Phương diện accessDateHour được thêm vào giản đồ Báo cáo truy cập dữ liệu. Thông số này chứa ngày và giờ của người dùng GA đã truy cập vào dữ liệu báo cáo GA.

5/10/2023 Các tài sản có mô hình phân bổ theo lượt nhấp đầu tiên, mô hình phân bổ tuyến tính, mô hình phân bổ mức giảm dựa trên thời gian và mô hình phân bổ dựa trên vị trí sẽ mặc định sử dụng mô hình phân bổ DDA trên nhiều kênh.

Kể từ giữa tháng 10 năm 2023, bạn sẽ không thể sử dụng mô hình phân bổ theo lượt nhấp đầu tiên, tuyến tính, mức giảm dựa trên thời gian và dựa trên vị trí với phương thức UpdateAttributionSettings cho tất cả tài sản.

Nếu tài sản của bạn hiện được thiết lập để sử dụng một trong các mô hình này, thì mô hình đó sẽ được thay đổi thành mô hình phân bổ dựa trên dữ liệu trên nhiều kênh. Bạn vẫn có thể sử dụng mô hình phân bổ Lượt nhấp cuối cùng trên nhiều kênh hoặc mô hình phân bổ ưu tiên lượt nhấp gần đây nhất từ Google Ads.

2023-09-01 Thêm các phương thức định cấu hình giản đồ giá trị lượt chuyển đổi SKAdNetwork.

GetSKAdNetworkConversionValueSchema, CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema, ListSKAdNetworkConversionValueSchemas các phương thức được thêm vào Admin API phiên bản 1 alpha.

Chức năng này cho phép quản lý cấu hình giản đồ giá trị lượt chuyển đổi SKAdNetwork cho một luồng iOS.

01/09/2023 Thêm phương thức UpdateConversionEvent.

Đã thêm phương thức UpdateConversionEvent vào Admin API phiên bản v1beta.

Trường BigQueryLink.enterprise_export_enabled 2023-09-01 được đổi tên thành fresh_daily_export_enabled.

Trường enterprise_export_enabled của tài nguyên BigQueryLink được đổi tên thành fresh_daily_export_enabled.

Ngày 14/7/2023 Thay đổi có thể gây lỗi đối với các phương thức properties.updateAttributionSettings, properties.getAttributionSettings.

Kể từ ngày 24 tháng 7 năm 2023, những thay đổi mang tính đột phá sẽ được thực hiện đối với Admin API phiên bản 1 alpha. Những thay đổi này sẽ ảnh hưởng đến chức năng của các phương thức properties.getAttributionSettings, properties.updateAttributionSettings.

Các thành viên của enum ReportingAttributionModel sẽ được đổi tên như sau:

Tên cũ Tên mới
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

Các thành viên của enum AdsWebConversionDataExportScope sẽ được đổi tên như sau:

Tên cũ Tên mới
CROSS_CHANNEL PAID_AND_ORGANIC_CHANNELS
ADS_PREFERRED GOOGLE_PAID_CHANNELS

2023-07-10 Đã thêm trường ads_web_conversion_data_export_scope vào loại AttributionSettings

Thêm trường ads_web_conversion_data_export_scope vào loại AttributionSettings. Bạn có thể sửa đổi trường này bằng phương thức UpdateAttributionSettings.

05/06/2023 Ngừng sử dụng mô hình phân bổ theo lượt nhấp đầu tiên, mô hình phân bổ tuyến tính, mô hình phân bổ mức giảm dựa trên thời gian và mô hình phân bổ dựa trên vị trí.

Kể từ tháng 6 năm 2023, bạn không thể dùng phương thức UpdateAttributionSettings để định cấu hình tài sản GA4 bằng mô hình phân bổ theo lượt nhấp đầu tiên, tuyến tính, mức giảm dựa trên thời gian và dựa trên vị trí. Kể từ tháng 9 năm 2023, các mô hình này sẽ không còn được cung cấp cho tất cả tài sản.

Hãy tham khảo thông báo về sản phẩm Google Analytics để biết thêm thông tin.

GetAdSenseLink, CreateAdSenseLink, DeleteAdSenseLink, ListAdSenseLinks các phương thức được thêm vào Admin API phiên bản 1 alpha.

Chức năng này cho phép quản lý mối liên kết giữa AdSense và Analytics cho một tài sản GA4.

2023-05-31 Thêm một phương thức để tra cứu tài sản GA4 đã kết nối.

Phương thức FetchConnectedGa4Property được thêm vào Admin API phiên bản 1 alpha

Chức năng này cho phép bạn thu thập thông tin về tài sản GA4 được liên kết với tài sản Universal Analytics trong quá trình di chuyển sang GA4.

2023-05-31 Thêm phương thức để quản lý các quy tắc tạo sự kiện.

Các phương thức CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules, GetEventCreateRule được thêm vào Admin API v1alpha.

Chức năng này cho phép quản lý các quy tắc tạo sự kiện. Các quy tắc này có thể kích hoạt việc tạo một sự kiện hoàn toàn mới dựa trên tiêu chí trùng khớp của một sự kiện nguồn.

2023-05-31 Thêm các phương thức để quản lý nhóm kênh tuỳ chỉnh.

Thêm các phương thức GetChannelGroup, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup, DeleteChannelGroup vào Admin API phiên bản 1 alpha.

Chức năng này cho phép quản lý nhóm kênh tuỳ chỉnh cho các nguồn lưu lượng truy cập vào trang web của bạn.

Sau khi tạo, bạn có thể truy vấn các nhóm kênh tuỳ chỉnh bằng cách sử dụng Google Analytics Data API phiên bản 1.

2023-03-31 Thêm các phương thức quản lý Chế độ cài đặt đo lường nâng cao.

Các phương thức properties.dataStreams.updateEnhancedMeasurementSettings, properties.dataStreams.getEnhancedMeasurementSettings được thêm vào Admin API phiên bản 1 alpha.

Chức năng này cho phép quản lý Chế độ cài đặt tính năng đo lường nâng cao cho một Luồng dữ liệu web của tài sản GA4.

Ngày 31/3/2023 Thêm các phương thức quản lý Thẻ trang web đã kết nối.

Các phương thức properties.createConnectedSiteTag, properties.deleteConnectedSiteTag, properties.listConnectedSiteTags được thêm vào Admin API phiên bản 1 alpha.

Chức năng này cho phép quản lý Thẻ trang web đã kết nối và hữu ích cho việc chuyển tiếp lưu lượng truy cập từ tài sản Universal Analytics sang tài sản Google Analytics 4.

2023-03-31 Đã thêm các phương thức runAccessReport cấp tài khoản và cấp tài sản vào Admin API phiên bản 1 beta.

Các phương thức properties.runAccessReport và accounts.runAccessReport được thêm vào phiên bản v1beta của Admin API. Các phương thức trả về một báo cáo tuỳ chỉnh về bản ghi truy cập dữ liệu.

2023-02-24 Thêm các phương thức quản lý Tập dữ liệu mở rộng.

Tài nguyên ExpandedDataSet đã được thêm vào phiên bản v1alpha của API, cùng với các thao tác properties.expandedDataSets.create, properties.expandedDataSets.delete, properties.expandedDataSets.patch, properties.expandedDataSets.list, properties.expandedDataSets.get tương ứng. Bạn có thể sử dụng chức năng này để quản lý Tập dữ liệu mở rộng trong Google Analytics 360.

Tài nguyên AccessBinding đã được thêm vào phiên bản v1alpha của API, cùng với các thao tác sau:

Chức năng này cho phép quản lý quyền của người dùng đối với một tài khoản hoặc tài sản GA4 và bạn nên sử dụng chức năng này thay vì Liên kết người dùng.

Chức năng Mối liên kết của người dùng sẽ bị xoá khỏi Admin API phiên bản 1 alpha vào ngày 1/6/2023

Ngày 24/2/2023 Ngừng sử dụng các phương thức kiểm tra quyền của người dùng.

Các phương thức sau đây không được dùng nữa và sẽ bị xoá khỏi Admin API phiên bản 1 alpha vào ngày 1/6/2023:

2023-02-24 Đã thêm các phương thức Quản lý đối tượng.

Tài nguyên Audience đã được thêm vào phiên bản v1alpha của API, cùng với các thao tác properties.audience.create, properties.audience.archive, properties.audience.patch, properties.audience.list, properties.audience.get tương ứng.

Chức năng này cho phép quản lý đối tượng cho một tài sản GA4.

15/02/2023 Thêm các phương thức chọn không sử dụng quy trình thiết lập GA4 tự động.

Các thao tác properties.setAutomatedGa4ConfigurationOptOut, properties.fetchAutomatedGa4ConfigurationOptOut đã được thêm vào phiên bản v1alpha của API.

Chức năng này cho phép quản lý trạng thái chọn không tham gia quy trình thiết lập GA4 tự động cho một tài sản UA.

Tài nguyên BigQueryLink đã được thêm vào phiên bản v1alpha của API, cùng với các thao tác properties.bigQueryLinks.get, properties.bigQueryLinks.list tương ứng.

Chức năng này cho phép truy xuất thông tin về các mối liên kết giữa một tài sản GA4 và một dự án BigQuery.

Tài nguyên SearchAds360Link đã được thêm vào phiên bản v1alpha của API, cùng với các thao tác properties.searchAds360Links.create, properties.searchAds360Links.delete, properties.searchAds360Links.patch, properties.searchAds360Links.list, properties.searchAds360Links.get tương ứng.

Chức năng này cho phép quản lý mối liên kết giữa một tài sản GA4 và một thực thể Search Ads 360.

Ngày 15/2/2023 Thay đổi có thể gây lỗi.

15/02/2023 Các thay đổi khác.

2022-08-11 Đã thêm phương thức runAccessReport vào Admin API phiên bản 1 alpha.

Phương thức properties.runAccessReport được thêm vào phiên bản v1alpha của Admin API. Thao tác này sẽ trả về một báo cáo tuỳ chỉnh về các bản ghi truy cập dữ liệu. Báo cáo này cung cấp bản ghi về mỗi lần người dùng đọc dữ liệu báo cáo trên Google Analytics. Quản trị viên của tài sản Google Analytics 360 có thể sử dụng Báo cáo về quyền truy cập vào dữ liệu.

11/7/2022 Phát hành phiên bản Admin API v1beta.

Chúng tôi đã phát hành phiên bản v1beta của API Quản trị Google Analytics.

Cả kênh Alpha và Beta của API đều tiếp tục được hỗ trợ cho Admin API. Kênh Beta chứa một số tính năng có trong kênh Alpha. Những tính năng này được coi là ổn định và dự kiến sẽ không có thay đổi đáng kể trong tương lai. Các tính năng mới sẽ được thêm vào phiên bản Beta sau khi hoàn thiện.

Ngày 12/10/2021 Các phương thức EnhancedMeasurementSettings đã bị xoá khỏi API.

  • Các phương thức properties.webDataStreams.getEnhancedMeasurementSettings, properties.webDataStreams.updateEnhancedMeasurementSettings sẽ bị xoá khỏi API, nhưng bạn sẽ sớm có thể sửa đổi chế độ cài đặt Đo lường nâng cao thông qua API.
  • Trường directRoles của tài nguyên UserLink không còn hỗ trợ vai trò predefinedRoles/manage-users nữa. Bạn nên sử dụng vai trò predefinedRoles/admin mới thay vì vai trò cũ. Vai trò này tương đương với tổ hợp vai trò predefinedRoles/edit và predefinedRoles/manage-users cũ. Thay đổi này ảnh hưởng đến hành vi của các phương thức accounts.userLinks, properties.userLinks và phù hợp với các thay đổi về quản lý quyền truy cập và quy định hạn chế về dữ liệu được giới thiệu trong Google Analytics.

05/06/2021 Thêm các tính năng.

Các tính năng sau đây được thêm vào API:

  • Đã thêm phương thức accounts.searchChangeHistoryEvents vào API. Phương thức này tìm kiếm tất cả các thay đổi đối với một tài khoản hoặc tài khoản con của tài khoản đó dựa trên bộ lọc được chỉ định. Các nguyên nhân thường gặp là nội dung cập nhật được thực hiện trong giao diện người dùng Google Analytics, các thay đổi từ nhóm hỗ trợ khách hàng hoặc các thay đổi tự động của hệ thống Google Analytics.
  • Đã thêm các phương thức quản lý mã thông báo bí mật cho Measurement Protocol trong properties.webDataStreams.measurementProtocolSecrets:
    • create Tạo một mã thông báo bí mật cho Measurement Protocol.
    • delete Xoá mã thông báo bí mật của Measurement Protocol mục tiêu.
    • get Tìm kiếm một mã thông báo bí mật duy nhất của Measurement Protocol.
    • list Trả về mã thông báo bí mật cho Measurement Protocol của tài sản con trong Tài sản mẹ được chỉ định.
    • patch Cập nhật một mã bí mật của Measurement Protocol.
  • Đã thêm các phương thức quản lý sự kiện chuyển đổi trong mục properties.conversionEvents:
    • create Tạo một sự kiện chuyển đổi có các thuộc tính được chỉ định.
    • delete Xoá một sự kiện chuyển đổi trong một tài sản.
    • get Truy xuất một sự kiện chuyển đổi.
    • list Trả về danh sách các sự kiện chuyển đổi trong tài sản mẹ được chỉ định.
  • Các phương thức quản lý phương diện tuỳ chỉnh được thêm trong properties.customDimensions:
    • archive Lưu trữ một phương diện tuỳ chỉnh trên một tài sản.
    • create Tạo một phương diện tuỳ chỉnh.
    • get Tìm kiếm một phương diện tuỳ chỉnh duy nhất.
    • list Liệt kê các phương diện tuỳ chỉnh trên một tài sản.
    • patch Cập nhật một phương diện tuỳ chỉnh trên một tài sản.
  • Thêm các phương thức quản lý chỉ số tuỳ chỉnh trong properties.customMetrics:
    • archive Lưu trữ một chỉ số tuỳ chỉnh trên một tài sản.
    • createTạo chỉ số tuỳ chỉnh.
    • get Tìm kiếm một chỉ số tuỳ chỉnh duy nhất.
    • list Liệt kê các chỉ số tuỳ chỉnh trên một tài sản.
    • patch Cập nhật một chỉ số tuỳ chỉnh trên một tài sản.
  • Đã thêm properties.getGoogleSignalsSettings, properties.updateGoogleSignalsSettings các phương thức cho phép kiểm soát chế độ cài đặt Tín hiệu của Google cho một tài sản Google Analytics 4.
  • delete_time, expire_time chỉ các trường đầu ra được thêm vào loại Property.

05/06/2021 Thay đổi có thể gây lỗi.

Chúng tôi đã giới thiệu những thay đổi sau đây có thể gây lỗi:

  • Các phương thức properties.iosAppDataStreams.create, properties.androidAppDataStreams.create đã bị xoá khỏi API. Vui lòng sử dụng Firebase để tạo luồng ứng dụng trong một tài sản Google Analytics 4.
  • Phương thức properties.delete hiện trả về dữ liệu thuộc tính đã xoá dưới dạng loại Property thay vì trả về một phản hồi trống.
  • Giờ đây, bạn bắt buộc phải điền vào trường time_zone của loại Property.
  • Đã xoá trường deleted khỏi loại Property.
  • Trường email_address của loại UserLink hiện không thể thay đổi.
  • name của trường UserLink hiện chỉ có đầu ra.

28/01/2021 Thay đổi có thể gây lỗi.

Thay đổi mang tính đột phá: – Trường update_mask là bắt buộc đối với tất cả các thao tác Cập nhật.

  • Đổi tên trường country_code thành region_code trong Account.

  • Đổi tên trường url_query_parameter thành uri_query_parameter trong EnhancedMeasurementSettings.

  • Đã xoá trường parent khỏi GoogleAdsLink.

20/10/2020 Bổ sung tính năng hỗ trợ cho thông tin tóm tắt về tài khoản.

Thêm tính năng hỗ trợ cho phương thức bản tóm tắt tài khoản.

13/10/2020 Thuộc tính Web và ứng dụng được đổi tên thành Google Analytics 4 (GA4).

15/08/2020 Đổi tên Management App + Web API thành Admin API.

API Quản lý của Google Analytics cho Web và ứng dụng đã được đổi tên thành API Quản trị của Google Analytics. Do đó, điểm cuối API đã thay đổi thành analyticsadmin.googleapis.com. Bạn cần cập nhật mã hiện có được viết dựa trên phiên bản trước của URL điểm cuối API và thư viện ứng dụng cho phù hợp.