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 dimensiones o métricas del informe incompatible hasta que este sea compatible.

Los informes en tiempo real y los informes 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

Parámetros
property

string

Es un identificador de propiedad de Google Analytics cuyos eventos se rastrean. Para obtener más información, consulta dónde encontrar el ID de tu propiedad. property debe tener el mismo valor que en tu solicitud de 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)

Son las dimensiones de este informe. dimensions debe tener el mismo valor que en tu solicitud de runReport.

metrics[]

object (Metric)

Son las métricas de este informe. metrics debe tener el mismo valor que en tu solicitud de runReport.

dimensionFilter

object (FilterExpression)

Es la cláusula de filtro de las dimensiones. dimensionFilter debe tener el mismo valor que en tu solicitud de runReport.

metricFilter

object (FilterExpression)

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

compatibilityFilter

enum (Compatibility)

Filtra las dimensiones y las métricas de la respuesta para que solo se muestre esta compatibilidad. Se usa de uso frecuente como ”compatibilityFilter”: “COMPATIBLE” para devolver solo las dimensiones y métricas compatibles.

Cuerpo de la respuesta

Es 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)

Es 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

Son los tipos de compatibilidad para una sola dimensión o métrica.

Enums
COMPATIBILITY_UNSPECIFIED Compatibilidad no especificada.
COMPATIBLE La dimensión o la métrica son compatibles. Esta dimensión o métrica se puede agregar correctamente a un informe.
INCOMPATIBLE La dimensión o la métrica no son compatibles. Esta dimensión o métrica no se puede agregar correctamente a un informe.

DimensionCompatibility

Es 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)

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

MetricCompatibility

Es 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 la métrica también contienen otra información útil, como el nombre y la descripción de la IU.

compatibility

enum (Compatibility)

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