Method: properties.checkCompatibility

Diese Kompatibilitätsmethode listet Dimensionen und Messwerte auf, die einer Berichtsanfrage hinzugefügt werden können, ohne die Kompatibilität zu beeinträchtigen. Diese Methode schlägt fehl, wenn die Dimensionen und Messwerte der Anfrage nicht kompatibel sind.

In Google Analytics werden Berichte nicht erstellt, wenn nicht kompatible 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 Echtzeit- und Basisberichte gelten unterschiedliche Kompatibilitätsregeln. Mit dieser Methode wird die Kompatibilität von Basisberichten 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 finden Sie unter Property-ID ermitteln. property muss mit dem Wert in Ihrer runReport-Anfrage übereinstimmen.

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 muss mit dem Wert in Ihrer runReport-Anfrage übereinstimmen.
metrics[]

object (Metric)

Die Messwerte in diesem Bericht. metrics muss mit dem Wert in Ihrer runReport-Anfrage übereinstimmen.
dimensionFilter

object (FilterExpression)

Die Filterklausel der Dimensionen. dimensionFilter muss mit dem Wert in Ihrer runReport-Anfrage übereinstimmen.
metricFilter

object (FilterExpression)

Die Filterklausel für Messwerte. metricFilter muss mit dem Wert in Ihrer runReport-Anfrage übereinstimmen.
compatibilityFilter

enum (Compatibility)

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

Antworttext

Die Kompatibilitätsantwort mit der Kompatibilität der einzelnen Dimensionen und Messwerte.

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

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

object (DimensionCompatibility)

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 in der Benutzeroberfläche.
compatibility

enum (Compatibility)

Kompatibilität dieser Dimension Wenn die Kompatibilität „KOMPATIBEL“ lautet, 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 in der Benutzeroberfläche.
compatibility

enum (Compatibility)

Kompatibilität dieses Messwerts. Wenn die Kompatibilität „KOMPATIBEL“ ist, kann dieser Messwert dem Bericht hinzugefügt werden.