Trang này được dịch bởi Cloud Translation API.

Nhật ký thay đổi

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

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

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

2024-08-01 Thêm tính năng quản lý mối liên kết với BigQuery

Đã thêm CreateBigQueryLink, UpdateBigQueryLink và DeleteBigQueryLink các phương pháp quản lý BigQueryLink tài nguyên với API Quản trị phiên bản 1alpha.

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 BIGQUERY_LINK mới giá trị 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ị v1alpha để phù hợp với phương thức tuỳ chỉnh .

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

GetEventEditRule! CreateEventEditRule, DeleteEventEditRule, ListEventEditRules, UpdateEventEditRules, ReorderEventEditRules, thêm 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í trùng khớp của một sự kiện nguồn. Ngoài ra, EventEditRule có thể xác định các nội dung sửa đổi của tham số từ nguồn sự kiện.

01/08/2024 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 một thời điểm bất kỳ. Chế độ cài đặt Từ primary đến 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 Account tài nguyên chứa URI của một 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 pháp quản lý sự kiện chính

Tài nguyên và phương thức cho khoá sự kiện đều có sẵn.

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 đã có báo cáo Quyền truy cập vào 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 quyền truy cập dữ liệu áp dụng cho tất cả các tài sản Google Analytics, cả tài sản Chuẩn và khách hàng Google Analytics 360.

Hãy xem tài liệu về giản đồ để 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 Quyền truy cập dữ liệu.

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

5/10/2023 Những 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 DDA trên nhiều kênh.

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

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, nó sẽ được đổ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 sẽ có các lựa chọn để sử dụng Lượt nhấp gần đây nhất trên nhiều kênh hoặc Ưu tiên lượt nhấp gần đây nhất từ Google Ads hãy nhấp vào.

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

GetSKAdNetworkConversionValueSchema! CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema, ListSKAdNetworkConversionValueSchemas thêm vào API Quản trị v1alpha.

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

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

UpdateConversionEvent đã thêm vào API Quản trị v1beta.

Đổi tên trường `BigQueryLink.enterprise_export_enabled` trong 2023-09-01 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.

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, một số thay đổi có thể gây lỗi sẽ được áp dụng cho API Quản trị phiên bản 1 alpha sẽ ảnh hưởng đến chức năng của properties.getAttributionSettings, properties.updateAttributionSettings .

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`

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`

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 có thể được sửa đổi bằng cách sử dụng thuộc tính UpdateAttributionSettings .

5/6/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, phần UpdateAttributionSettings Bạn không thể sử dụng phương thức này để định cấu hình tài sản GA4 có lượt nhấp đầu tiên tuyến tính, giảm dựa trên thời gian và dựa trên vị trí các mô hình phân bổ. Kể từ tháng 9 năm 2023, các mô hình này sẽ trở thành không áp dụng cho tất cả tài sản.

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

31/05/2023 Thêm các phương pháp quản lý mối liên kết với AdSense.

GetAdSenseLink! CreateAdSenseLink, DeleteAdSenseLink, ListAdSenseLinks thêm vào API Quản trị v1alpha.

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

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

FetchConnectedGa4Property được thêm vào API Quản trị v1alpha

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

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

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

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

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

Đã thêm GetChannelGroup, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup, DeleteChannelGroup cho API Quản trị v1alpha.

Chức năng này cho phép quản lý nhóm kênh tuỳ chỉnh cho 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 API Dữ liệu của Google Analytics phiên bản 1.

31/03/2023 Thêm các phương pháp quản lý cho 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ị phiên bản 1alpha.

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 tài sản GA4.

31/03/2023 Thêm các phương pháp 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ị phiên bản 1alpha.

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

31/03/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ị phiên bản 1beta.

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

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

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

24/02/2023 Liên kết quyền truy cập sẽ thay thế Đường liên kết của người dùng để quản lý quyền của người dùng.

AccessBinding tài nguyên đã được thêm vào phiên bản v1alpha của API, cùng với các phép toán 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 GA4 hoặc và nên được sử dụng thay cho Đường liên kết người dùng.

Chức năng Đường liên kết đến người dùng sẽ bị xoá trong API Quản trị phiên bản 1 (alpha) vào ngày 1/6/2023

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

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

24/02/2023 Thêm phương pháp quản lý đối tượng.

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

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

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

properties.setAutomatedGa4ConfigurationOptOut! Chúng tôi đã thêm các thao tác properties.fetchAutomatedGa4ConfigurationOptOut vào phiên bản v1alpha của API.

Chức năng này giúp bạn quản lý trạng thái chọn không sử dụng GA4 tự động quy trình thiết lập cho một tài sản UA.

15-02-2023 Thêm các phương pháp quản lý đường liên kết đến BigQuery.

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

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

15/02/2023 Thêm các phương pháp quản lý mối liên kết với Search Ads 360.

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

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

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

Đã xoá các giá trị LESS_THAN_OR_EQUAL, GREATER_THAN_OR_EQUAL khỏi NumericFilter.Operation enum.
Đã xoá giá trị PARTIAL_REGEXP khỏi StringFilter.MatchType enum.

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

Đã thêm trường tokensPerProjectPerHour vào AccessQuota loại.
EXPANDED_DATA_SET, CHANNEL_GROUP giá trị đã được thêm vào ChangeHistoryResourceType enum.
Đã thêm các giá trị searchAds360Link, expandedDataSet, bigqueryLink vào ChangeHistoryResource.

11/08/2022 Thêm phương thức `runAccessReport` vào API Quản trị phiên bản 1alpha.

properties.runAccessReport thêm phương thức vào phiên bản v1alpha của API Quản trị. Hàm này trả về một giá trị báo cáo tuỳ chỉnh về bản ghi truy cập dữ liệu. Báo cáo này cung cấp hồ sơ của từng khi 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 là dành cho Quản trị viên của các 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.

Phiên bản beta v1 của Google Analytics Admin API đã được phát hành.

Cả kênh Alpha và Beta của API vẫn tiếp tục được hỗ trợ cho Quản trị viên API. Kênh beta chứa một tập hợp con các tính năng có trong giai đoạn Alpha mà được coi là ổn định và không được dự kiến sẽ trải qua thay đổi đáng kể về tương lai. Chúng tôi sẽ thêm các tính năng mới vào bản thử nghiệm sau khi phát triển xong.

12/10/2021 Đã xoá các phương pháp EnhancedMeasurementSettings khỏi API.

properties.webDataStreams.getEnhancedMeasurementSettings, Các phương thức properties.webDataStreams.updateEnhancedMeasurementSettings xoá khỏi API, nhưng xoá tính năng Đo lường nâng cao cài đặt sẽ sớm có thể sửa đổi lại thông qua API.
Trường directRoles của UserLink tài nguyên 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 tổ hợp predefinedRoles/edit cũ và predefinedRoles/manage-users vai trò. Thay đổi này ảnh hưởng đến hành vi của accounts.userLinks! properties.userLinks và phù hợp với Quản lý quyền truy cập và quy định hạn chế về dữ liệu những thay đổi đượ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 sẽ được thêm vào API:

accounts.searchChangeHistoryEvents đã được thêm vào API. Phương thức này tìm kiếm qua tất cả các thay đổi đối với tài khoản hoặc nhà xuất bản con của tài khoản đó dựa trên tập hợp bộ lọc được chỉ định. Nguyên nhân thường gặp sẽ là nội dung cập nhật trong giao diện người dùng Google Analytics, các thay đổi do khách hàng thực hiện hoặc các thay đổi tự động của hệ thống Google Analytics.
Đã thêm các phương pháp quản lý mã thông báo bí mật cho Measurement Protocol trong properties.webDataStreams.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.
- get Tìm 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 của giao thức đo lường 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.
Các phương thức quản lý sự kiện chuyển đổi đã được thêm trong properties.conversionEvents:
- create Tạo một sự kiện chuyển đổi có các thuộc tính đã chỉ định.
- delete Xoá một sự kiện chuyển đổi trong 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ẹ đã chỉ định.
Các phương pháp quản lý phương diện tuỳ chỉnh đã được thêm vào 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 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 phương pháp quản lý chỉ số tùy chỉnh trong properties.customMetrics:
- archive Lưu trữ chỉ số tuỳ chỉnh trên một tài sản.
- create sẽ mở lại chỉ số tuỳ chỉnh.
- get Tì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 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 Google Tín hiệu cho tài sản Google Analytics 4.
delete_time! expire_time các trường chỉ có đầu ra được thêm vào Property loại.

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

Chúng tôi đã triển khai những thay đổi có thể gây lỗi sau đây:

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

28/01/2021 Thêm tính năng hỗ trợ phân trang cho thao tác `ListFirebaseLinks`.

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

Thay đổi có thể gây lỗi: – Trường update_mask là trường bắt buộc cho mọi thao tác Cập nhật.

Trường country_code được đổi tên thành region_code trong Account.
Trường url_query_parameter được đổi tên thành uri_query_parameter trong EnhancedMeasurementSettings.
Đã xoá trường parent khỏi GoogleAdsLink.

2020-10-20 Thêm tính năng hỗ trợ cho tính năng tóm tắt tài khoản.

Đã thêm tùy chọn hỗ trợ cho phương thức tóm tắt tài khoản.

13/10/2020: Đổi tên Tài sản web và ứng dụng thành Google Analytics 4 (GA4).

15/08/2020 Đổi tên API Web và ứng dụng quản lý thành API Quản trị.

API Web và ứng dụng quản lý Google Analytics đã được đổi tên thành API Quản trị của Google Analytics. Do đó, điểm cuối của API đã thay đổi thành analyticsadmin.googleapis.com. 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 cần được cập nhật tương ứng.