- Yêu cầu HTTP
- Tham số đường dẫn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- Khả năng tương thích
- DimensionCompatibility
- MetricCompatibility
- Hãy làm thử!
Phương thức tương thích này liệt kê những phương diện và chỉ số có thể thêm vào yêu cầu báo cáo và duy trì khả năng tương thích. Phương pháp này sẽ không thành công nếu phương diện và chỉ số của yêu cầu không tương thích.
Trong Google Analytics, báo cáo sẽ không thành công nếu chúng yêu cầu những phương diện và/hoặc chỉ số không tương thích. Trong trường hợp đó, bạn sẽ phải xoá phương diện và/hoặc chỉ số khỏi báo cáo không tương thích cho đến khi báo cáo đó tương thích.
Báo cáo Theo thời gian thực và báo cáo chính có các quy tắc tương thích khác nhau. Phương thức này kiểm tra khả năng tương thích của các Báo cáo chính.
Yêu cầu HTTP
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:checkCompatibility
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Tham số | |
---|---|
property |
Giá trị nhận dạng tài sản GA4 của Google Analytics có các sự kiện được theo dõi. Để tìm hiểu thêm, hãy xem cách tìm mã tài sản của bạn. Ví dụ: thuộc tính/1234 |
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{ "dimensions": [ { object ( |
Trường | |
---|---|
dimensions[] |
Các phương diện trong báo cáo này. |
metrics[] |
Các chỉ số trong báo cáo này. |
dimensionFilter |
Mệnh đề bộ lọc của phương diện. |
metricFilter |
Mệnh đề bộ lọc của chỉ số. |
compatibilityFilter |
Lọc các phương diện và chỉ số trong phản hồi để chỉ lọc khả năng tương thích này. Thường được dùng làm |
Nội dung phản hồi
Phản hồi về khả năng tương thích cho biết khả năng tương thích của từng phương diện và chỉ số.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{ "dimensionCompatibilities": [ { object ( |
Trường | |
---|---|
dimensionCompatibilities[] |
Khả năng tương thích của từng phương diện. |
metricCompatibilities[] |
Khả năng tương thích của từng chỉ số. |
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau đây:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
Khả năng tương thích
Các loại khả năng tương thích cho một phương diện hoặc chỉ số.
Enum | |
---|---|
COMPATIBILITY_UNSPECIFIED |
Chưa xác định khả năng tương thích. |
COMPATIBLE |
Phương diện hoặc chỉ số này tương thích. Bạn có thể thêm thành công phương diện hoặc chỉ số này vào một báo cáo. |
INCOMPATIBLE |
Phương diện hoặc chỉ số này không tương thích. Không thể thêm thành công phương diện hoặc chỉ số này vào báo cáo. |
DimensionCompatibility
Khả năng tương thích của một phương diện.
Biểu diễn dưới dạng JSON |
---|
{ "dimensionMetadata": { object ( |
Trường | |
---|---|
dimensionMetadata |
Siêu dữ liệu phương diện chứa tên API cho thông tin về khả năng tương thích này. Siêu dữ liệu phương diện cũng chứa các thông tin hữu ích khác như tên và nội dung mô tả của giao diện người dùng. |
compatibility |
Khả năng tương thích của phương diện này. Nếu khả năng tương thích tương thích, phương diện này có thể được thêm thành công vào báo cáo. |
MetricCompatibility
Khả năng tương thích của một chỉ số.
Biểu diễn dưới dạng JSON |
---|
{ "metricMetadata": { object ( |
Trường | |
---|---|
metricMetadata |
Siêu dữ liệu của chỉ số chứa tên API cho thông tin về khả năng tương thích này. Siêu dữ liệu chỉ số cũng chứa các thông tin hữu ích khác như tên và nội dung mô tả giao diện người dùng. |
compatibility |
Khả năng tương thích của chỉ số này. Nếu khả năng tương thích tương thích, thì bạn có thể thêm chỉ số này vào báo cáo. |