Method: properties.checkCompatibility

Bu uyumluluk yöntemi, bir rapor isteğine eklenebilecek ve uyumluluğu koruyabilecek boyutları ve metrikleri listeler. İsteğin boyutları ve metrikleri uyumsuzsa bu yöntem başarısız olur.

Google Analytics'te raporlar, uyumsuz boyutlar ve/veya metrikler istediğinde başarısız olur. Bu durumda, rapor uyumlu olana kadar uyumlu olmayan rapordan boyutları ve/veya metrikleri kaldırmanız gerekir.

Gerçek zamanlı raporlar ve temel raporlar farklı uyumluluk kurallarına sahiptir. Bu yöntem, Temel raporların uyumluluğunu kontrol eder.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
property

string

Etkinlikleri izlenen bir Google Analytics GA4 mülk tanımlayıcısı. Daha fazla bilgi için Mülk kimliğinizi nerede bulacağınızı öğrenin. property, runReport isteğinizdeki değerle aynı olmalıdır.

Örnek: mülkler/1234

İstek içeriği

İstek gövdesi, aşağıdaki yapıyla veriler içerir:

JSON gösterimi
{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "compatibilityFilter": enum (Compatibility)
}
Alanlar
dimensions[]

object (Dimension)

Bu rapordaki boyutlar. dimensions, runReport isteğinizdeki değerle aynı olmalıdır.

metrics[]

object (Metric)

Bu rapordaki metrikler. metrics, runReport isteğinizdeki değerle aynı olmalıdır.

dimensionFilter

object (FilterExpression)

Boyutların filtre koşulu. dimensionFilter, runReport isteğinizdeki değerle aynı olmalıdır.

metricFilter

object (FilterExpression)

Metriklerin filtre koşulu. metricFilter, runReport isteğinizdeki değerle aynı olmalıdır

compatibilityFilter

enum (Compatibility)

Yalnızca bu uyumluluğa göre verilen yanıtta boyutları ve metrikleri filtreler. Yalnızca uyumlu boyutları ve metrikleri döndürmek için genellikle ”compatibilityFilter”: “COMPATIBLE” olarak kullanılır.

Yanıt gövdesi

Her bir boyut ve metriğin uyumluluğuyla uyumluluk yanıtı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "dimensionCompatibilities": [
    {
      object (DimensionCompatibility)
    }
  ],
  "metricCompatibilities": [
    {
      object (MetricCompatibility)
    }
  ]
}
Alanlar
dimensionCompatibilities[]

object (DimensionCompatibility)

Her boyutun uyumluluğu.

metricCompatibilities[]

object (MetricCompatibility)

Her metriğin uyumluluğu.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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

Uyumluluk

Tek bir boyut veya metrik için uyumluluk türleri.

Sıralamalar
COMPATIBILITY_UNSPECIFIED Uyumluluk belirtilmedi.
COMPATIBLE Boyut veya metrik uyumlu. Bu boyut veya metrik bir rapora başarıyla eklenebilir.
INCOMPATIBLE Boyut veya metrik uyumsuzdur. Bu boyut veya metrik bir rapora başarıyla eklenemez.

BoyutUyumluluğu

Tek bir boyut için uyumluluk.

JSON gösterimi
{
  "dimensionMetadata": {
    object (DimensionMetadata)
  },
  "compatibility": enum (Compatibility)
}
Alanlar
dimensionMetadata

object (DimensionMetadata)

Boyut meta verileri, bu uyumluluk bilgilerine ilişkin API adını içerir. Boyut meta verileri, kullanıcı arayüzü adı ve açıklaması gibi diğer faydalı bilgileri de içerir.

compatibility

enum (Compatibility)

Bu boyutun uyumluluğu. Uyumluluk UYUMLU ise bu boyut rapora başarıyla eklenebilir.

Metrik Uyumluluğu

Tek bir metrik için uyumluluk.

JSON gösterimi
{
  "metricMetadata": {
    object (MetricMetadata)
  },
  "compatibility": enum (Compatibility)
}
Alanlar
metricMetadata

object (MetricMetadata)

Metrik meta verileri, bu uyumluluk bilgilerine ilişkin API adını içerir. Metrik meta verileri, kullanıcı arayüzü adı ve açıklaması gibi diğer faydalı bilgileri de içerir.

compatibility

enum (Compatibility)

Bu metriğin uyumluluğu. Uyumluluk UYUMLU ise bu metrik rapora başarıyla eklenebilir.