Method: properties.checkCompatibility

Ta metoda zgodności zawiera listę wymiarów i danych, które można dodać do żądania raportu i zachować zgodność. Ta metoda się nie uda, jeśli wymiary i dane żądania są niezgodne.

W przypadku Google Analytics raporty nie powiedzie się, jeśli zażądają niezgodnych wymiarów lub danych. W takim przypadku musisz usunąć wymiary lub dane z niezgodnego raportu do czasu, aż raport stanie się zgodny.

Raporty Czas rzeczywisty i Podstawowe mają różne reguły zgodności. Ta metoda sprawdza zgodność raportów podstawowych.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
property

string

Identyfikator usługi w GA4 w Google Analytics, której zdarzenia są śledzone. Dowiedz się, gdzie znaleźć identyfikator usługi. Pole property powinno mieć taką samą wartość jak w żądaniu runReport.

Przykład: właściwość/1234

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

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

object (Dimension)

Wymiary w tym raporcie. Pole dimensions powinno mieć taką samą wartość jak w żądaniu runReport.
metrics[]

object (Metric)

Dane w tym raporcie. Pole metrics powinno mieć taką samą wartość jak w żądaniu runReport.
dimensionFilter

object (FilterExpression)

Klauzula filtra wymiarów. Pole dimensionFilter powinno mieć taką samą wartość jak w żądaniu runReport.
metricFilter

object (FilterExpression)

Klauzula filtra danych. Pole metricFilter powinno mieć taką samą wartość jak w żądaniu runReport
compatibilityFilter

enum (Compatibility)

Filtruje wymiary i dane w odpowiedzi tylko na tę zgodność. Zwykle używany jako atrybut ”compatibilityFilter”: “COMPATIBLE” do zwracania tylko zgodnych wymiarów i danych.

Treść odpowiedzi

Odpowiedź dotycząca zgodności z informacjami o zgodności poszczególnych wymiarów i danych.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "dimensionCompatibilities": [
    {
      object (DimensionCompatibility)
    }
  ],
  "metricCompatibilities": [
    {
      object (MetricCompatibility)
    }
  ]
}
Pola
dimensionCompatibilities[]

object (DimensionCompatibility)

Zgodność poszczególnych wymiarów.
metricCompatibilities[]

object (MetricCompatibility)

Zgodność poszczególnych danych.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

Zgodność

Typy zgodności w przypadku pojedynczego wymiaru lub rodzaju danych.

Wartości w polu enum
COMPATIBILITY_UNSPECIFIED Nieokreślona zgodność.
COMPATIBLE Wymiar lub dane są zgodne. Ten wymiar lub dane można dodać do raportu.
INCOMPATIBLE Wymiar lub dane są niezgodne. Tego wymiaru lub rodzaju danych nie można dodać do raportu.

DimensionCompatibility

Zgodność pojedynczego wymiaru.

Zapis JSON 
{
  "dimensionMetadata": {
    object (DimensionMetadata)
  },
  "compatibility": enum (Compatibility)
}
Pola
dimensionMetadata

object (DimensionMetadata)

Metadane wymiaru zawierają nazwę interfejsu API na potrzeby tych informacji o zgodności. Metadane wymiaru zawierają też inne przydatne informacje, takie jak nazwa interfejsu i opis.
compatibility

enum (Compatibility)

Zgodność tego wymiaru. Jeśli zgodność jest zgodna z zasadami, ten wymiar można dodać do raportu.

MetricCompatibility

Zgodność pojedynczego rodzaju danych.

Zapis JSON 
{
  "metricMetadata": {
    object (MetricMetadata)
  },
  "compatibility": enum (Compatibility)
}
Pola
metricMetadata

object (MetricMetadata)

Metadane wskaźnika zawierają nazwę interfejsu API na potrzeby tych informacji o zgodności. Metadane wskaźnika zawierają też inne przydatne informacje, takie jak nazwa interfejsu i opis.
compatibility

enum (Compatibility)

Zgodność tego wskaźnika. Jeśli zgodność jest oznaczona jako KOMPATYBILNA, te dane można dodać do raportu.