Nhật ký thay đổi

Để biết 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 20 tháng 1 năm 2025 Thêm thời gian 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 1alpha và 1beta. Sử dụng trường này để truy xuất hoặc sửa đổi chế độ cài đặt thời gian 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 quyền truy cập

Tài liệu về phương thức runAccessReport đã được cập nhật để thêm đường liên kết đến biểu mẫu Phản hồi về báo cáo quyền 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ĩ về API này để giúp chúng tôi cải thiện API này 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 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 theo giá trị BIGQUERY_LINK mới trong ChangeHistoryResourceType.

01/08/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 API quản trị viên phiên bản 1alpha để phù hợp với nguyên tắc về phương thức tuỳ chỉnh.

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, các phương thức được thêm vào API quản trị phiên bản 1alpha.

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 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 sửa đổi đối với 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. Tại một thời điểm, chỉ một nhóm kênh mới 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.

Ngày 6 tháng 5 năm 2024 Thêm các phương thức quản lý sự kiện chính

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

Sửa đổi chế độ 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 Báo cáo quyền truy cập dữ liệu hiện đã có cho tất cả tài sản Google Analytics.

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

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 Phương diện accessDateHour được thêm vào giản đồ báo cáo Quyền truy cập dữ liệu.

Phương diện accessDateHour được thêm vào Giản đồ báo cáo quyền truy cập dữ liệu. Trường 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.

Ngày 5 tháng 10 năm 2023 Các tài sản 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í 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 các 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 đị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ổ 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.

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.

Thêm các phương thức GetSKAdNetworkConversionValueSchema, CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema, ListSKAdNetworkConversionValueSchemas vào API quản trị phiên bản 1alpha.

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.

Thêm phương thức UpdateConversionEvent vào API quản trị viên phiên bản 1beta.

Ngày 1 tháng 9 năm 2023 Đổi tên trường BigQueryLink.enterprise_export_enabled 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 tháng 7 năm 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, chúng tôi sẽ thực hiện các thay đổi có thể gây lỗi đối với API quản trị phiên bản alpha v1. Điều 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

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 có thể được 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 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 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.

Thêm các phương thức GetAdSenseLink, CreateAdSenseLink, DeleteAdSenseLink, ListAdSenseLinks vào API quản trị phiên bản 1alpha.

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 đã kết nối.

Thêm phương thức FetchConnectedGa4Property vào API Quản trị phiên bản 1alpha

Chức năng này cho phép bạn thu thập thông tin về tài sản GA4 đã liên kết với tài sản Universal Analytics của bạn 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ý 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ó thể 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.

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 Admin API v1alpha.

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 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 cách sử dụng Google Analytics Data API phiên bản 1.

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.

Các phương thức properties.dataStreams.updateEnhancedMeasurementSettings, properties.dataStreams.getEnhancedMeasurementSettings được thêm vào Admin API v1alpha.

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 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 Admin API 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 Admin API phiên bản 1beta.

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 trả về một báo cáo tuỳ chỉnh về bản ghi 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ì Mối liên kết của người dùng.

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

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òn được dùng nữa và sẽ bị xoá khỏi Admin API phiên bản 1 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 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 sử dụng 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 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 có thể gây lỗi.

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ị phiên bản 1alpha.

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 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 của Google Analytics. Báo cáo quyền truy cập dữ liệu chỉ dành cho Quản trị viên của tài sản Google Analytics 360.

Ngày 11 tháng 7 năm 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ị của Google Analytics.

Cả kênh Alpha và Beta của API đều tiếp tục được hỗ trợ cho API quản trị. Kênh Beta chứa một tập hợp con các tính năng có trong Alpha được coi là ổn định và dự kiến sẽ không có thay đổi đáng kể nào trong tương lai. Các tính năng mới sẽ được thêm vào phiên bản thử nghiệm 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.

  • 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 lại chế độ cài đặt Tính năng đ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. Thay vào đó, bạn nên sử dụng vai trò predefinedRoles/admin mới, tương đương với tổ hợp các 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.

Ngày 5 tháng 6 năm 2021 Thêm 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ả thay đổi đối với một tài khoản hoặc cá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 phổ biến là nội dung cập nhật trong giao diện người dùng Google Analytics, thay đổi do nhóm hỗ trợ khách hàng thực hiện hoặc thay đổi tự động đối với hệ thống Google Analytics.
  • Thêm các phương thức quản lý mã thông báo bí mật của Measurement Protocol trong properties.webDataStreams.measurementProtocolSecrets:
    • create Tạo một khoá bí mật cho giao thức đo lường.
    • deleteXoá mã thông báo bí mật của giao thức đo lường mục tiêu.
    • get Tìm kiếm một mã thông báo bí mật duy nhất của giao thức đo lường.
    • list Trả về mã thông báo bí mật của giao thức đo lường con trong Tài sản mẹ được chỉ định.
    • patch Cập nhật khoá bí mật của Measurement Protocol.
  • Các phương thức quản lý sự kiện chuyển đổi được thêm vào properties.conversionEvents:
    • create Tạo một sự kiện chuyển đổi có các thuộc tính được chỉ định.
    • deleteXoá 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 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 Tìm kiếm 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 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 Tìm kiếm 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 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 chỉ xuất ra các trường được thêm vào loại Property.

Ngày 5 tháng 6 năm 2021 Thay đổi có thể gây lỗi.

Chúng tôi đã đưa ra các thay đổi có thể gây lỗi 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 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ề phản hồi trống.
  • Giờ đây, bạn bắt buộc phải điền trường time_zone thuộc 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.
  • Trường name thuộc loại UserLink hiện chỉ có đầu ra.

Ngày 28 tháng 1 năm 2021 Thay đổi có thể gây lỗi.

Thay đổi có thể gây lỗi: – Trường update_mask là bắt buộc đối với tất 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 Bổ sung tính năng hỗ trợ cho bản 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 Thuộc tính web và ứng dụng được đổi tên thành Google Analytics 4 (GA4).

Ngày 15 tháng 8 năm 2020 Đổi tên Ứng dụng quản lý + API web thành API quản trị.

API Quản lý ứng dụng và web của Google Analytics đã đượ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.