Method: properties.checkCompatibility

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

string

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. property phải giống với giá trị trong yêu cầu runReport 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 (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "compatibilityFilter": enum (Compatibility)
}
Trường
dimensions[]

object (Dimension)

Các phương diện trong báo cáo này. dimensions phải giống với giá trị trong yêu cầu runReport của bạn.
metrics[]

object (Metric)

Các chỉ số trong báo cáo này. metrics phải giống với giá trị trong yêu cầu runReport của bạn.
dimensionFilter

object (FilterExpression)

Mệnh đề bộ lọc của phương diện. dimensionFilter phải giống với giá trị trong yêu cầu runReport của bạn.
metricFilter

object (FilterExpression)

Mệnh đề bộ lọc của chỉ số. metricFilter phải giống với giá trị trong yêu cầu runReport của bạn
compatibilityFilter

enum (Compatibility)

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 ”compatibilityFilter”: “COMPATIBLE” để chỉ trả về các phương diện và chỉ số tương thích.

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 (DimensionCompatibility)
    }
  ],
  "metricCompatibilities": [
    {
      object (MetricCompatibility)
    }
  ]
}
Trường
dimensionCompatibilities[]

object (DimensionCompatibility)

Khả năng tương thích của từng phương diện.
metricCompatibilities[]

object (MetricCompatibility)

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 (DimensionMetadata)
  },
  "compatibility": enum (Compatibility)
}
Trường
dimensionMetadata

object (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

enum (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 (MetricMetadata)
  },
  "compatibility": enum (Compatibility)
}
Trường
metricMetadata

object (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

enum (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.