Method: properties.checkCompatibility

Ta metoda sprawdzania zgodności wyświetla listę wymiarów i danych, które można dodać do żądania raportu bez utraty zgodności. Ta metoda zwraca błąd, jeśli wymiary i dane w żądaniu są niezgodne.

W Google Analytics raporty nie działają, jeśli żądają niezgodnych wymiarów lub danych. W takim przypadku musisz usunąć wymiary lub dane z niezgodnego raportu, aż stanie się on zgodny.

Raporty w czasie rzeczywistym i podstawowe mają różne reguły zgodności. Ta metoda sprawdza zgodność w przypadku 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 Google Analytics, której zdarzenia są śledzone. Więcej informacji znajdziesz w artykule Gdzie znaleźć identyfikator usługi. property powinna mieć taką samą wartość 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. dimensions powinna mieć taką samą wartość jak w żądaniu runReport.
metrics[]

object (Metric)

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

object (FilterExpression)

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

object (FilterExpression)

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

enum (Compatibility)

Filtruje wymiary i dane w odpowiedzi, aby uwzględniać tylko te, które są zgodne. Zwykle używane jako ”compatibilityFilter”: “COMPATIBLE”, aby zwracać tylko zgodne wymiary i dane.

Treść odpowiedzi

Odpowiedź dotycząca zgodności z informacjami o zgodności każdego wymiaru 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ść każdego wymiaru.
metricCompatibilities[]

object (MetricCompatibility)

Zgodność każdego typu 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 dla pojedynczego wymiaru lub 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 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, takie jak nazwa i opis w interfejsie.
compatibility

enum (Compatibility)

Zgodność tego wymiaru. Jeśli zgodność jest określona jako COMPATIBLE, ten wymiar można dodać do raportu.

MetricCompatibility

Zgodność pojedynczych danych.

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

object (MetricMetadata)

Metadane danych zawierają nazwę interfejsu API dla tych informacji o zgodności. Metadane danych zawierają też inne przydatne informacje, takie jak nazwa i opis w interfejsie.
compatibility

enum (Compatibility)

Zgodność tych danych. Jeśli zgodność jest określona jako COMPATIBLE, te dane można dodać do raportu.