Method: properties.checkCompatibility

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

In Google Analytics schlagen Berichte fehl, wenn darin 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 den Echtzeit- und den Core-Bericht gelten unterschiedliche Kompatibilitätsregeln. Mit dieser Methode wird die Kompatibilität mit 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 Ihre Property-ID finden property sollte der gleiche Wert wie in der 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 der gleiche Wert wie in der runReport-Anfrage sein.
metrics[]

object (Metric)

Die Messwerte in diesem Bericht. metrics sollte der gleiche Wert wie in der runReport-Anfrage sein.
dimensionFilter

object (FilterExpression)

Die Filterklausel von Dimensionen. dimensionFilter sollte der gleiche Wert wie in der runReport-Anfrage sein.
metricFilter

object (FilterExpression)

Die Filterklausel von Messwerten. metricFilter sollte derselbe Wert wie in der runReport-Anfrage sein
compatibilityFilter

enum (Compatibility)

Filtert die Dimensionen und Messwerte nur nach dieser Kompatibilität Wird häufig als ”compatibilityFilter”: “COMPATIBLE” verwendet, um nur kompatible Dimensionen und Messwerte.

Antworttext

Die Kompatibilitätsantwort mit der Kompatibilität jeder Dimension und Messwert.

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 Kompatibilität nicht angegeben.
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 konnte 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 weitere nützliche Informationen wie den UI-Namen und die Beschreibung.
compatibility

enum (Compatibility)

Die Kompatibilität dieser Dimension. Wenn die Kompatibilität KOMPATIBEL 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 UI-Namen und die Beschreibung.
compatibility

enum (Compatibility)

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