Method: properties.checkCompatibility

Bei dieser Kompatibilitätsmethode werden Dimensionen und Messwerte aufgelistet, die einer Berichtsanfrage hinzugefügt werden können, um die Kompatibilität zu wahren. Diese Methode schlägt fehl, wenn die Dimensionen und Messwerte der Anfrage nicht kompatibel sind.

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

Die Echtzeit- und die Kernberichte haben unterschiedliche Kompatibilitätsregeln. Mit dieser Methode wird die Kompatibilität von grundlegenden Berichten 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

Eine Google Analytics GA4-Property-ID, deren Ereignisse erfasst werden. Weitere Informationen dazu, wo Sie die Property-ID finden property muss mit dem Wert in der 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 der runReport-Anfrage übereinstimmen.
metrics[]

object (Metric)

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

object (FilterExpression)

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

object (FilterExpression)

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

enum (Compatibility)

Filtert die Dimensionen und Messwerte als Reaktion 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 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)

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 Metadaten der Dimension enthalten auch weitere hilfreiche Informationen wie den Namen und die Beschreibung der Benutzeroberfläche.
compatibility

enum (Compatibility)

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

MetricCompatibility

Die Kompatibilität eines einzelnen Messwerts.

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

object (MetricMetadata)

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

enum (Compatibility)

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