Method: properties.checkCompatibility

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

W Google Analytics raporty nie powiodą się, jeśli zażądają niezgodnych wymiarów lub danych. W takim przypadku musisz usunąć wymiary lub dane z niezgodnego raportu, aby raport był zgodny.

Raporty Czas rzeczywisty i raporty podstawowe mają różne reguły zgodności. Ta metoda sprawdza zgodność z podstawowymi raportami.

Żą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órego zdarzenia są śledzone. Więcej informacji znajdziesz w artykule, gdzie znaleźć identyfikator usługi. Wartość property powinna być taka sama jak w żądaniu runReport.

Przykład: properties/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. Wartość dimensions powinna być taka sama jak w żądaniu runReport.
metrics[]

object (Metric)

Dane w tym raporcie. Wartość metrics powinna być taka sama jak w żądaniu runReport.
dimensionFilter

object (FilterExpression)

Klauzula filtrowania wymiarów. Wartość dimensionFilter powinna być taka sama jak w żądaniu runReport.
metricFilter

object (FilterExpression)

Klauzula filtra wskaźników. Wartość metricFilter powinna być taka sama jak w żądaniu runReport
compatibilityFilter

enum (Compatibility)

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

Treść odpowiedzi

odpowiedź dotyczącą zgodności ze zgodnością każdego wymiaru, 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 protokołu OAuth:

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

Zgodność

Typy zgodności 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. Nie można dodać tego wymiaru lub danych do raportu.

DimensionCompatibility

Zgodność pojedynczego wymiaru.

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

object (DimensionMetadata)

Metadane wymiaru zawierają nazwę interfejsu API dla tych informacji o zgodności. Metadane wymiaru zawierają też inne przydatne informacje, np. nazwę i opis UI.
compatibility

enum (Compatibility)

Zgodność tego wymiaru. Jeśli zgodność ma wartość ZGODNOŚĆ, ten wymiar można dodać do raportu.

MetricCompatibility

Zgodność pojedynczego wskaźnika.

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

object (MetricMetadata)

Metadane wskaźnika zawierają nazwę interfejsu API dla tych informacji o zgodności. Metadane wskaźnika zawierają też inne przydatne informacje, np. nazwę i opis interfejsu.
compatibility

enum (Compatibility)

Zgodność tych danych. Jeśli zgodność ma wartość ZGODNOŚĆ, te dane można dodać do raportu.