Method: properties.checkCompatibility

Este método de compatibilidad enumera las dimensiones y métricas que se pueden agregar a una solicitud de informe y mantener la compatibilidad. Este método falla si las dimensiones y las métricas de la solicitud no son compatibles.

En Google Analytics, los informes fallan si solicitan dimensiones o métricas incompatibles. En ese caso, deberás quitar las dimensiones o métricas del informe incompatible hasta que sea compatible.

Los informes En tiempo real y Principales tienen diferentes reglas de compatibilidad. Este método verifica la compatibilidad de los informes principales.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
property

string

Es un identificador de propiedad de Google Analytics cuyos eventos se registran. Para obtener más información, consulta dónde encontrar el ID de tu propiedad. property debe ser el mismo valor que en tu solicitud runReport.

Ejemplo: properties/1234

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON
{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "compatibilityFilter": enum (Compatibility)
}
Campos
dimensions[]

object (Dimension)

Las dimensiones de este informe. dimensions debe ser el mismo valor que en tu solicitud runReport.

metrics[]

object (Metric)

Las métricas de este informe metrics debe ser el mismo valor que en tu solicitud runReport.

dimensionFilter

object (FilterExpression)

La cláusula de filtro de las dimensiones. dimensionFilter debe ser el mismo valor que en tu solicitud runReport.

metricFilter

object (FilterExpression)

Es la cláusula de filtro de las métricas. metricFilter debe ser el mismo valor que en tu solicitud runReport.

compatibilityFilter

enum (Compatibility)

Filtra las dimensiones y métricas de la respuesta solo para esta compatibilidad. Se usa comúnmente como ”compatibilityFilter”: “COMPATIBLE” para mostrar solo dimensiones y métricas compatibles.

Cuerpo de la respuesta

La respuesta de compatibilidad con la compatibilidad de cada dimensión y métrica

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON
{
  "dimensionCompatibilities": [
    {
      object (DimensionCompatibility)
    }
  ],
  "metricCompatibilities": [
    {
      object (MetricCompatibility)
    }
  ]
}
Campos
dimensionCompatibilities[]

object (DimensionCompatibility)

La compatibilidad de cada dimensión

metricCompatibilities[]

object (MetricCompatibility)

La compatibilidad de cada métrica

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

Compatibilidad

Los tipos de compatibilidad de una sola dimensión o métrica.

Enumeraciones
COMPATIBILITY_UNSPECIFIED Compatibilidad no especificada.
COMPATIBLE La dimensión o métrica es compatible. Esta dimensión o métrica se puede agregar correctamente a un informe.
INCOMPATIBLE La dimensión o métrica es incompatible. Esta dimensión o métrica no se puede agregar correctamente a un informe.

DimensionCompatibility

La compatibilidad para una sola dimensión.

Representación JSON
{
  "dimensionMetadata": {
    object (DimensionMetadata)
  },
  "compatibility": enum (Compatibility)
}
Campos
dimensionMetadata

object (DimensionMetadata)

Los metadatos de la dimensión contienen el nombre de la API para esta información de compatibilidad. Los metadatos de la dimensión también contienen otra información útil, como el nombre y la descripción de la IU.

compatibility

enum (Compatibility)

La compatibilidad de esta dimensión. Si la compatibilidad es COMPATIBLE, esta dimensión se puede agregar correctamente al informe.

MetricCompatibility

La compatibilidad para una sola métrica.

Representación JSON
{
  "metricMetadata": {
    object (MetricMetadata)
  },
  "compatibility": enum (Compatibility)
}
Campos
metricMetadata

object (MetricMetadata)

Los metadatos de la métrica contienen el nombre de la API para esta información de compatibilidad. Los metadatos de las métricas también contienen otra información útil, como el nombre y la descripción de la IU.

compatibility

enum (Compatibility)

La compatibilidad de esta métrica. Si la compatibilidad es COMPATIBLE, esta métrica se puede agregar correctamente al informe.