Method: properties.checkCompatibility

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

Di Google Analytics, laporan akan gagal jika meminta dimensi dan/atau metrik yang tidak kompatibel. Dalam hal ini, Anda harus menghapus dimensi dan/atau metrik dari laporan yang tidak kompatibel sampai laporan tersebut kompatibel.

Laporan Real-Time dan Laporan Inti 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. property harus memiliki nilai yang sama dengan yang ada di 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 dengan yang ada di permintaan runReport Anda.

metrics[]

object (Metric)

Metrik dalam laporan ini. metrics harus memiliki nilai yang sama dengan yang ada di permintaan runReport Anda.

dimensionFilter

object (FilterExpression)

Klausa filter dimensi. dimensionFilter harus memiliki nilai yang sama dengan yang ada di permintaan runReport Anda.

metricFilter

object (FilterExpression)

Klausa filter metrik. metricFilter harus bernilai sama dengan yang ada dalam permintaan runReport Anda

compatibilityFilter

enum (Compatibility)

Memfilter dimensi dan metrik sebagai respons terhadap kompatibilitas ini saja. Biasanya digunakan sebagai ”compatibilityFilter”: “COMPATIBLE” untuk hanya menampilkan dimensi & metrik yang kompatibel.

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 dimensi atau metrik tunggal.

Enum
COMPATIBILITY_UNSPECIFIED Kompatibilitas tidak ditentukan.
COMPATIBLE Dimensi atau metrik 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 kompatibilitasnya KOMPATIBEL, dimensi ini dapat berhasil ditambahkan ke laporan.

MetricCompatibility

Kompatibilitas untuk metrik tunggal.

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 kompatibilitasnya KOMPATIBEL, metrik ini dapat ditambahkan ke laporan.