Method: properties.checkCompatibility

Metode kompatibilitas ini mencantumkan dimensi dan metrik yang dapat ditambahkan ke permintaan laporan dan mempertahankan kompatibilitas. Metode ini akan gagal jika dimensi dan metrik permintaan tidak kompatibel.

Di Google Analytics, laporan akan gagal jika meminta dimensi dan/atau metrik yang tidak kompatibel; Jika demikian, Anda harus menghapus dimensi dan/atau metrik dari laporan yang tidak kompatibel hingga laporan tersebut kompatibel.

Laporan Real-Time dan Core memiliki aturan kompatibilitas yang berbeda. Metode ini memeriksa kompatibilitas untuk laporan Inti.

Permintaan HTTP

POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:checkCompatibility

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
property

string

ID properti GA4 Google Analytics yang peristiwanya dilacak. Untuk mempelajari lebih lanjut, lihat tempat menemukan ID Properti Anda. property harus memiliki nilai yang sama seperti dalam permintaan runReport Anda.

Contoh: properties/1234

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "compatibilityFilter": enum (Compatibility)
}
Kolom
dimensions[]

object (Dimension)

Dimensi dalam laporan ini. dimensions harus memiliki nilai yang sama seperti dalam permintaan runReport Anda.
metrics[]

object (Metric)

Metrik dalam laporan ini. metrics harus memiliki nilai yang sama seperti dalam permintaan runReport Anda.
dimensionFilter

object (FilterExpression)

Klausa filter dimensi. dimensionFilter harus memiliki nilai yang sama seperti dalam permintaan runReport Anda.
metricFilter

object (FilterExpression)

Klausa filter metrik. Nilai metricFilter harus sama dengan yang ada di permintaan runReport Anda
compatibilityFilter

enum (Compatibility)

Memfilter dimensi dan metrik dalam merespons hanya untuk kompatibilitas ini. Biasanya digunakan sebagai ”compatibilityFilter”: “COMPATIBLE” untuk hanya menampilkan dimensi & metrik.

Isi respons

Respons kompatibilitas dengan kompatibilitas setiap dimensi & metrik.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "dimensionCompatibilities": [
    {
      object (DimensionCompatibility)
    }
  ],
  "metricCompatibilities": [
    {
      object (MetricCompatibility)
    }
  ]
}
Kolom
dimensionCompatibilities[]

object (DimensionCompatibility)

Kompatibilitas setiap dimensi.
metricCompatibilities[]

object (MetricCompatibility)

Kompatibilitas setiap metrik.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

Kompatibilitas

Jenis kompatibilitas untuk satu dimensi atau metrik.

Enum
COMPATIBILITY_UNSPECIFIED Kompatibilitas tidak ditentukan.
COMPATIBLE Dimensi atau metrik ini kompatibel. Dimensi atau metrik ini berhasil ditambahkan ke laporan.
INCOMPATIBLE Dimensi atau metrik tidak kompatibel. Dimensi atau metrik ini tidak berhasil ditambahkan ke laporan.

DimensionCompatibility

Kompatibilitas untuk satu dimensi.

Representasi JSON 
{
  "dimensionMetadata": {
    object (DimensionMetadata)
  },
  "compatibility": enum (Compatibility)
}
Kolom
dimensionMetadata

object (DimensionMetadata)

Metadata dimensi berisi nama API untuk informasi kompatibilitas ini. Metadata dimensi juga berisi informasi bermanfaat lainnya seperti nama dan deskripsi UI.
compatibility

enum (Compatibility)

Kompatibilitas dimensi ini. Jika kompatibilitas KOMPATIBEL, dimensi ini dapat ditambahkan ke laporan.

MetricCompatibility

Kompatibilitas untuk satu metrik.

Representasi JSON 
{
  "metricMetadata": {
    object (MetricMetadata)
  },
  "compatibility": enum (Compatibility)
}
Kolom
metricMetadata

object (MetricMetadata)

Metadata metrik berisi nama API untuk informasi kompatibilitas ini. Metadata metrik juga berisi informasi bermanfaat lainnya seperti nama dan deskripsi UI.
compatibility

enum (Compatibility)

Kompatibilitas metrik ini. Jika kompatibilitas KOMPATIBEL, metrik ini dapat ditambahkan ke laporan.