Nhật ký thay đổi

Để xem các 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.

Ngày 18 tháng 6 năm 2026 Đã thêm phương thức UpdateReportingIdentitySettings

Ngày 18 tháng 6 năm 2026 Đã thêm trường can_edit vào PropertySummary

  • Đã thêm trường can_edit vào tài nguyên PropertySummary trong API Quản trị v1alpha và v1beta. Trường này cho biết liệu người dùng có vai trò trong Google Analytics cho phép họ thay đổi chế độ cài đặt trên tài sản hay không.

Ngày 14 tháng 4 năm 2026 Đã thêm phương thức GetUserProvidedDataSettings

Ngày 20 tháng 8 năm 2025 Đã thêm phương thức GetReportingIdentitySettings

Đã thêm phương thức GetReportingIdentitySettings vào API Quản trị v1alpha, cho phép bạn truy xuất ReportingIdentitySettings cho một tài sản.

Ngày 20 tháng 8 năm 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 API Quản trị v1alpha: SetAutomatedGa4ConfigurationOptOut, FetchAutomatedGa4ConfigurationOptOut, CreateConnectedSiteTag, DeleteConnectedSiteTag, ListConnectedSiteTags và FetchConnectedGa4Property.

Ngày 12 tháng 6 năm 2025 Đã 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 API Quản trị v1alpha.

Ngày 16 tháng 4 năm 2025 Đã thêm các phương thức quản lý chú thích dữ liệu báo cáo

Đã thêm CreateReportingDataAnnotation, GetReportingDataAnnotation, ListReportingDataAnnotations, UpdateReportingDataAnnotation và DeleteReportingDataAnnotation phương thức để quản lý ReportingDataAnnotation tài nguyên bằng API Quản trị v1alpha.

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 v1beta vào tháng 6 năm 2025.

Ngày 20 tháng 1 năm 2025 Đã thêm tính năng lưu giữ dữ liệu người dùng vào DataRetentionSettings

Đã thêm trường userDataRetention vào DataRetentionSettings trong API Quản trị v1alpha và v1beta. Hãy sử dụng trường này để truy xuất hoặc sửa đổi chế độ cài đặt lưu giữ dữ liệu người dùng.

Ngày 9 tháng 9 năm 2024 Biểu mẫu khảo sát về Báo cáo truy cập

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

Đã thêm CreateBigQueryLink, UpdateBigQueryLink và DeleteBigQueryLink các phương thức để quản lý BigQueryLink tài nguyên bằng API Quản trị v1alpha.

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

Đã thêm các thay đổi về đường liên kết đến 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 mang tính đột phá đối với phương thức createSubproperty

Đổi tên phương thức tuỳ chỉnh createSubproperty thành provisionSubproperty trong API Quản trị v1alpha để phù hợp với nguyên tắc về phương thức tuỳ chỉnh guidelines.

Ngày 1 tháng 8 năm 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, đã thêm các phương thức vào API Quản trị v1alpha.

EventEditRule xác định các đ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 tiêu chí phù hợ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.

Ngày 1 tháng 8 năm 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. Chỉ một nhóm kênh có thể đặt primary thành true tại bất kỳ thời điểm nào. 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, 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.

Ngày 6 tháng 5 năm 2024 Đã thêm các phương thức quản lý sự kiện quan trọng

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

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

Ngày 15 tháng 12 năm 2023 Hiện đã có báo cáo về quyền truy cập dữ liệu cho tất cả tài sản Google Analytics.

Một số trường của tính năng Báo cáo về quyền truy cập dữ liệu hiện đã có cho tất cả tài sản Google Analytics, cả khách hàng sử dụng gói Tiêu chuẩn và Google Analytics 360.

Hãy xem tài liệu về giản đồ để biết thêm thông tin.

Ngày 15 tháng 12 năm 2023 Đã thêm phương diện accessDateHour vào giản đồ Báo cáo về quyền truy cập dữ liệu.

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

Ngày 5 tháng 10 năm 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ẽ sử dụng mô hình phân bổ dựa trên dữ liệu (DDA) trên nhiều kênh theo mặc đị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í bằng 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 định cấu hình để sử dụng một trong các mô hình này, thì tài sản đó 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ổ theo 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 cuối cùng từ Google Ads.

Ngày 1 tháng 9 năm 2023 Đã 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 đã thêm các phương thức vào API Quản trị v1alpha.

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 luồng iOS.

Ngày 1 tháng 9 năm 2023 Đã thêm phương thức UpdateConversionEvent.

UpdateConversionEvent đã thêm phương thức vào API Quản trị v1beta.

Ngày 1 tháng 9 năm 2023 Đổi tên trường BigQueryLink.enterprise_export_enabled thành fresh_daily_export_enabled.

Đổi tên trường enterprise_export_enabled của tài nguyên BigQueryLink thành fresh_daily_export_enabled.

Ngày 14 tháng 7 năm 2023 Thay đổi mang tính đột phá đối với các phương thức properties.updateAttributionSettings, properties.getAttributionSettings.

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

Các thành viên của ReportingAttributionModel enum 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 AdsWebConversionDataExportScope enum 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

Ngày 10 tháng 7 năm 2023 Đã 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 mà bạn có thể sửa đổi bằng phương thức UpdateAttributionSettings.

Ngày 5 tháng 6 năm 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ể sử dụng phương thức UpdateAttributionSettings để định cấu hình các tài sản GA4 bằ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 9 năm 2023, bạn sẽ không thể sử dụng các mô hình này 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 đã thêm các phương thức vào API Quản trị v1alpha.

Chức năng này cho phép quản lý các đường liên kết từ AdSense đến Analytics cho một tài sản GA4.

Ngày 31 tháng 5 năm 2023 Đã thêm một phương thức để tra cứu tài sản GA4 được kết nối.

Đã thêm FetchConnectedGa4Property phương thức vào API Quản trị v1alpha

Chức năng này cho phép bạn lấy thông tin về một 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.

Ngày 31 tháng 5 năm 2023 Đã thêm phương thức để quản lý quy tắc tạo sự kiện.

Đã thêm các phương thức CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules, GetEventCreateRule vào API Quản trị v1alpha.

Chức năng này cho phép quản lý các quy tắc tạo sự kiện 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í phù hợp của một sự kiện nguồn.

Ngày 31 tháng 5 năm 2023 Đã 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 API Quản trị v1alpha.

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

Sau khi tạo, bạn có thể truy vấn các nhóm kênh tuỳ chỉnh bằng Google Analytics Data API v1.

Ngày 31 tháng 3 năm 2023 Đã thêm các phương thức quản lý Chế độ cài đặt đo lường nâng cao.

Đã thêm các phương thức properties.dataStreams.updateEnhancedMeasurementSettings, properties.dataStreams.getEnhancedMeasurementSettings vào API Quản trị v1alpha.

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

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

Đã thêm các phương thức properties.createConnectedSiteTag, properties.deleteConnectedSiteTag, properties.listConnectedSiteTags vào API Quản trị v1alpha.

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.

Ngày 31 tháng 3 năm 2023 Đã thêm các phương thức runAccessReport ở cấp tài khoản và tài sản vào API Quản trị v1beta.

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

Ngày 24 tháng 2 năm 2023 Đã 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 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 Liên kết người dùng sẽ bị xoá khỏi API Quản trị v1 alpha vào ngày 1 tháng 6 năm 2023

Ngày 24 tháng 2 năm 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 API Quản trị v1 alpha vào ngày 1 tháng 6 năm 2023:

Ngày 24 tháng 2 năm 2023 Đã 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.

Ngày 15 tháng 2 năm 2023 Đã thêm các phương thức chọn không tham gia 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 đường liên kết giữa Tài sản GA4 và 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ý các đường 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 tháng 2 năm 2023 Thay đổi mang tính đột phá.

Ngày 15 tháng 2 năm 2023 Các thay đổi khác.

Ngày 11 tháng 8 năm 2022 Đã thêm phương thức runAccessReport vào API Quản trị v1alpha.

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

Ngày 11 tháng 7 năm 2022 Đã phát hành phiên bản API Quản trị v1beta.

Đã phát hành phiên bản v1beta của Google Analytics Admin API.

Cả kênh Alpha và Beta của API đều tiếp tục được hỗ trợ cho API Quản trị. Kênh thử nghiệm Beta chứa một tập hợp con các tính năng có trong kênh Alpha đượ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 kênh Beta sau khi hoàn thiện.

Ngày 12 tháng 10 năm 2021 Đã xoá các phương thức EnhancedMeasurementSettings khỏi API.

  • properties.webDataStreams.getEnhancedMeasurementSettings, properties.webDataStreams.updateEnhancedMeasurementSettings các phương thức đã 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. Bạn nên sử dụng vai trò predefinedRoles/admin mới, tương đương với sự kết hợp của các vai trò predefinedRoles/edit và predefinedRoles/manage-users cũ. Thay đổi này ảnh hưởng đến hành vi của accounts.userLinks, properties.userLinks các phương thức và phù hợp với các thay đổi về quản lý quyền truy cập và hạn chế dữ liệu được giới thiệu trong Google Analytics.

Ngày 5 tháng 6 năm 2021 Đã thêm các tính năng.

Đã thêm các tính năng sau vào API:

  • accounts.searchChangeHistoryEvents đã thêm phương thức 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 tập hợp bộ lọc được chỉ định. Các nguyên nhân thường gặp là các bản cập nhật được thực hiện trong giao diện người dùng Google Analytics, các thay đổi từ bộ phận 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.dataStreams.measurementProtocolSecrets:
    • create Tạo mã thông báo bí mật cho Measurement Protocol.
    • delete Xoá mã thông báo bí mật cho Measurement Protocol mục tiêu.
    • get Tra cứu một mã thông báo bí mật cho Measurement Protocol.
    • list Trả về các mã thông báo bí mật cho Measurement Protocol con trong Tài sản mẹ được chỉ định.
    • patch Cập nhật mã thông báo bí mật cho Measurement Protocol.
  • Đã thêm các phương thức quản lý sự kiện chuyển đổi trong 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.
  • Đã thêm các phương thức quản lý phương diện tuỳ chỉnh 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 Tra cứu một phương diện tuỳ chỉnh.
    • 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.
    • create Tạo một chỉ số tuỳ chỉnh.
    • get Tra cứu một chỉ số tuỳ chỉnh.
    • 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 các phương thức properties.getGoogleSignalsSettings, properties.updateGoogleSignalsSettings 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 các trường chỉ có đầu ra đã thêm vào loại Property.

Ngày 5 tháng 6 năm 2021 Thay đổi mang tính đột phá.

Chúng tôi đã giới thiệu các thay đổi mang tính đột phá sau:

  • Đã xoá các phương thức properties.iosAppDataStreams.create, properties.androidAppDataStreams.create 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.
  • properties.delete phương thức hiện trả về dữ liệu tài sản đã xoá dưới dạng loại Property thay vì trả về phản hồi trống.
  • time_zone trường của loại Property hiện là bắt buộc.
  • Đã xoá trường deleted khỏi loại Property type.
  • email_address trường của loại UserLink hiện không thể thay đổi.
  • name trường của loại UserLink hiện chỉ có đầu ra.

Ngày 28 tháng 1 năm 2021 Thay đổi mang tính đột phá.

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.

Ngày 20 tháng 10 năm 2020 Đã thêm tính năng hỗ trợ cho tóm tắt tài khoản.

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

Ngày 13 tháng 10 năm 2020 Đổi tên tài sản Ứng dụng + Web thành Google Analytics 4 (GA4).

Ngày 15 tháng 8 năm 2020 Đổi tên API Web và ứng dụng thành API Quản trị.

Đã đổi tên API Quản lý Web và ứng dụng của Google Analytics thành Google Analytics Admin API. 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.