Method: properties.checkCompatibility

Questo metodo di compatibilità elenca le dimensioni e le metriche che possono essere aggiunte a una richiesta di report e mantengono la compatibilità. Questo metodo non va a buon fine se le dimensioni e le metriche della richiesta non sono compatibili.

In Google Analytics, i report non riescono se richiedono dimensioni e/o metriche incompatibili. in tal caso, dovrai rimuovere le dimensioni e/o le metriche dal report incompatibile finché il report non sarà compatibile.

I report In tempo reale e quelli principali hanno regole di compatibilità diverse. Questo metodo verifica la compatibilità per i report principali.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
property

string

Un identificatore di proprietà GA4 di Google Analytics di cui vengono monitorati gli eventi. Per scoprire di più, scopri dove trovare il tuo ID proprietà. property deve essere lo stesso valore nella tua richiesta runReport.

Esempio: proprietà/1234

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "compatibilityFilter": enum (Compatibility)
}
Campi
dimensions[]

object (Dimension)

Le dimensioni in questo report. dimensions deve essere lo stesso valore nella tua richiesta runReport.

metrics[]

object (Metric)

Le metriche in questo report. metrics deve essere lo stesso valore nella tua richiesta runReport.

dimensionFilter

object (FilterExpression)

La clausola del filtro delle dimensioni. dimensionFilter deve essere lo stesso valore nella tua richiesta runReport.

metricFilter

object (FilterExpression)

La clausola di filtro delle metriche. metricFilter deve essere lo stesso valore nella tua richiesta runReport

compatibilityFilter

enum (Compatibility)

Filtra le dimensioni e le metriche nella risposta solo in base a questa compatibilità. Comunemente utilizzato come ”compatibilityFilter”: “COMPATIBLE” per restituire solo dimensioni e dimensioni compatibili metriche di valutazione.

Corpo della risposta

La risposta relativa alla compatibilità con la compatibilità di ogni dimensione in un file di dati.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "dimensionCompatibilities": [
    {
      object (DimensionCompatibility)
    }
  ],
  "metricCompatibilities": [
    {
      object (MetricCompatibility)
    }
  ]
}
Campi
dimensionCompatibilities[]

object (DimensionCompatibility)

La compatibilità di ogni dimensione.

metricCompatibilities[]

object (MetricCompatibility)

La compatibilità di ogni metrica.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Compatibilità

I tipi di compatibilità per una singola dimensione o metrica.

Enum
COMPATIBILITY_UNSPECIFIED Compatibilità non specificata.
COMPATIBLE La dimensione o la metrica è compatibile. Questa dimensione o metrica può essere aggiunta correttamente a un report.
INCOMPATIBLE La dimensione o la metrica non è compatibile. Impossibile aggiungere questa dimensione o metrica a un report.

DimensionCompatibility

La compatibilità per una singola dimensione.

Rappresentazione JSON
{
  "dimensionMetadata": {
    object (DimensionMetadata)
  },
  "compatibility": enum (Compatibility)
}
Campi
dimensionMetadata

object (DimensionMetadata)

I metadati della dimensione contengono il nome dell'API per queste informazioni di compatibilità. I metadati delle dimensioni contengono anche altre informazioni utili, come il nome e la descrizione dell'interfaccia utente.

compatibility

enum (Compatibility)

La compatibilità di questa dimensione. Se la compatibilità è COMPATIBILE, questa dimensione può essere aggiunta correttamente al report.

MetricCompatibility

La compatibilità per una singola metrica.

Rappresentazione JSON
{
  "metricMetadata": {
    object (MetricMetadata)
  },
  "compatibility": enum (Compatibility)
}
Campi
metricMetadata

object (MetricMetadata)

I metadati della metrica contengono il nome dell'API per queste informazioni di compatibilità. I metadati della metrica contengono anche altre informazioni utili, come il nome e la descrizione dell'interfaccia utente.

compatibility

enum (Compatibility)

La compatibilità di questa metrica. Se la compatibilità è COMPATIBILE, questa metrica può essere aggiunta correttamente al report.