Method: properties.checkCompatibility

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

Raporty w Google Analytics nie działają, jeśli zawierają niezgodne wymiary lub dane. W takim przypadku musisz usunąć z raportu niezgodne wymiary lub dane, aż będzie on zgodny.

Raporty Czas rzeczywisty i Podstawowe mają inne reguły zgodności. Ta metoda sprawdza zgodność raportów Core.

Żą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 Google Analytics, której zdarzenia są śledzone. Więcej informacji znajdziesz w sekcji Gdzie znaleźć identyfikator usługi. Wartość property powinna być taka sama jak w prośbie 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 prośbie runReport.

metrics[]

object (Metric)

Dane w tym raporcie. Wartość metrics powinna być taka sama jak w prośbie runReport.

dimensionFilter

object (FilterExpression)

Klauzula filtra wymiarów. Wartość dimensionFilter powinna być taka sama jak w prośbie runReport.

metricFilter

object (FilterExpression)

Klauzula filtra danych. Wartość metricFilter powinna być taka sama jak w żądaniu runReport

compatibilityFilter

enum (Compatibility)

Filtruje wymiary i dane w odpowiedzi tylko pod kątem tej zgodności. Zwykle używane jako ”compatibilityFilter”: “COMPATIBLE”, aby zwracać tylko zgodne wymiary i dane.

Treść odpowiedzi

Odpowiedź dotycząca zgodności z poszczególnymi wymiarami i danymi.

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 pojedynczego wymiaru lub danych.

Wartości w polu enum
COMPATIBILITY_UNSPECIFIED Nieokreślona zgodność.
COMPATIBLE Wymiar lub dane są zgodne. Wymiar lub dane można dodać do raportu.
INCOMPATIBLE Wymiar lub dane są niezgodne. Wymiaru lub 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 dla tych informacji o zgodności. Metadane wymiaru zawierają też inne przydatne informacje, np. nazwę i opis w interfejsie.

compatibility

enum (Compatibility)

Zgodność tego wymiaru. Jeśli zgodność jest oznaczona jako TAK, wymiar można dodać do raportu.

MetricCompatibility

Zgodność pojedynczego rodzaju danych.

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

object (MetricMetadata)

Metadane dotyczące danych zawierają nazwę interfejsu API, która odpowiada tym informacjom o zgodności. Metadane danych zawierają też inne przydatne informacje, np. nazwę i opis w interfejsie.

compatibility

enum (Compatibility)

Zgodność tych danych. Jeśli zgodność jest zgodna, dane można dodać do raportu.