Method: properties.checkCompatibility

In dieser Kompatibilitätsmethode werden Dimensionen und Messwerte aufgeführt, die einer Berichtsanfrage hinzugefügt werden können, ohne dass die Kompatibilität beeinträchtigt wird. Diese Methode schlägt fehl, wenn die Dimensionen und Messwerte der Anfrage nicht kompatibel sind.

In Google Analytics schlagen Berichte fehl, wenn in ihnen inkompatible Dimensionen und/oder Messwerte angefordert werden. In diesem Fall müssen Sie Dimensionen und/oder Messwerte aus dem inkompatiblen Bericht entfernen, bis er kompatibel ist.

Für die Echtzeit- und Kernberichte gelten unterschiedliche Kompatibilitätsregeln. Mit dieser Methode wird die Kompatibilität für Core-Berichte geprüft.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
property

string

Die ID einer Google Analytics-Property, deren Ereignisse erfasst werden. Weitere Informationen property sollte derselbe Wert wie in Ihrer runReport-Anfrage sein.

Beispiel: properties/1234

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

object (Dimension)

Die Dimensionen in diesem Bericht. dimensions sollte derselbe Wert wie in Ihrer runReport-Anfrage sein.
metrics[]

object (Metric)

Die Messwerte in diesem Bericht. metrics sollte derselbe Wert wie in Ihrer runReport-Anfrage sein.
dimensionFilter

object (FilterExpression)

Die Filterklausel für Dimensionen. dimensionFilter sollte derselbe Wert wie in Ihrer runReport-Anfrage sein.
metricFilter

object (FilterExpression)

Die Filterklausel für Messwerte. metricFilter sollte derselbe Wert wie in Ihrer runReport-Anfrage sein.
compatibilityFilter

enum (Compatibility)

Filtert die Dimensionen und Messwerte in der Antwort auf diese Kompatibilität. Wird häufig als ”compatibilityFilter”: “COMPATIBLE” verwendet, um nur kompatible Dimensionen und Messwerte zurückzugeben.

Antworttext

Die Kompatibilitätsantwort mit der Kompatibilität jeder Dimension und jedes Messwerts.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "dimensionCompatibilities": [
    {
      object (DimensionCompatibility)
    }
  ],
  "metricCompatibilities": [
    {
      object (MetricCompatibility)
    }
  ]
}
Felder
dimensionCompatibilities[]

object (DimensionCompatibility)

Die Kompatibilität der einzelnen Dimensionen.
metricCompatibilities[]

object (MetricCompatibility)

Die Kompatibilität der einzelnen Messwerte.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Kompatibilität

Die Kompatibilitätstypen für eine einzelne Dimension oder einen einzelnen Messwert.

Enums
COMPATIBILITY_UNSPECIFIED Nicht angegebene Kompatibilität.
COMPATIBLE Die Dimension oder der Messwert ist kompatibel. Diese Dimension oder dieser Messwert kann einem Bericht hinzugefügt werden.
INCOMPATIBLE Die Dimension oder der Messwert ist nicht kompatibel. Diese Dimension oder dieser Messwert kann einem Bericht nicht hinzugefügt werden.

DimensionCompatibility

Die Kompatibilität für eine einzelne Dimension.

JSON-Darstellung 
{
  "dimensionMetadata": {
    object (DimensionMetadata)
  },
  "compatibility": enum (Compatibility)
}
Felder
dimensionMetadata

object (DimensionMetadata)

Die Dimensionsmetadaten enthalten den API-Namen für diese Kompatibilitätsinformationen. Die Dimensionsmetadaten enthalten auch andere nützliche Informationen wie den Namen und die Beschreibung der Benutzeroberfläche.
compatibility

enum (Compatibility)

Die Kompatibilität dieser Dimension. Wenn die Kompatibilität COMPATIBLE ist, kann diese Dimension dem Bericht hinzugefügt werden.

MetricCompatibility

Die Kompatibilität für einen einzelnen Messwert.

JSON-Darstellung 
{
  "metricMetadata": {
    object (MetricMetadata)
  },
  "compatibility": enum (Compatibility)
}
Felder
metricMetadata

object (MetricMetadata)

Die Messwertmetadaten enthalten den API-Namen für diese Kompatibilitätsinformationen. Die Messwertmetadaten enthalten auch andere nützliche Informationen wie den Namen und die Beschreibung der Benutzeroberfläche.
compatibility

enum (Compatibility)

Die Kompatibilität dieses Messwerts. Wenn die Kompatibilität COMPATIBLE ist, kann dieser Messwert dem Bericht hinzugefügt werden.