Method: customers.analysisQueries.validate

Realiza verificaciones de validación estáticas en la consulta de análisis proporcionada.

Solicitud HTTP

POST https://adsdatahub.googleapis.com/v1/{parent=customers/*}/analysisQueries:validate

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

Parámetros de ruta de acceso

Parámetros
parent

string

El nombre del recurso superior al que pertenece la consulta, p.ej., &clientes/123'.

Cuerpo de la solicitud

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

Representación JSON
{
  "query": {
    object (AnalysisQuery)
  },
  "adsDataCustomerId": string,
  "matchDataCustomerId": string,
  "spec": {
    object (QueryExecutionSpec)
  },
  "includePerformanceInfo": boolean
}
Campos
query

object (AnalysisQuery)

La consulta que se validará.

adsDataCustomerId
(deprecated)

string (int64 format)

Opcional. Es el ID de cliente del Centro de Datos de Anuncios vinculado que se usará para validar los datos de anuncios y el acceso a la tabla temporal. La configuración predeterminada es todos los clientes vinculados. Ya no está disponible. Use el parámetro adsDataCustomerId dentro de query_execution_spec.

matchDataCustomerId
(deprecated)

string (int64 format)

Opcional. Es el ID de cliente específico del Centro de Datos de Anuncios que se usará para validar los datos de coincidencias y el acceso a la tabla temporal. La configuración predeterminada es todos los clientes vinculados. Ya no está disponible. Use el valor de match_table_customer_id en query_execution_spec.

spec

object (QueryExecutionSpec)

Opcional. Los campos duplicados dentro de query_execution_spec anularán los campos externos.

includePerformanceInfo

boolean

Opcional. Si es verdadero, llama a BigQuery para ejecutar la consulta en seco a fin de recopilar información de rendimiento. Es posible que tarde más en comparación con solo validar la consulta. Se deben configurar startDate, endDate y los parámetros dentro de query_execution_spec para la ejecución de prueba.

Cuerpo de la respuesta

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

Respuesta a una solicitud de análisisQueries.validate.

Representación JSON
{
  "processedBytes": string,
  "queryPerformanceInfo": {
    object (QueryPerformanceInfo)
  },
  "filteredRowSummary": {
    object (FilteredRowSummary)
  }
}
Campos
processedBytes
(deprecated)

string (int64 format)

Este campo es obsoleto y usa queryPerformanceInfo en su lugar. Bytes de datos que lee esta consulta. Consulte https://cloud.google.com/bigquery/pricing#data para obtener detalles sobre cómo se calcula. Se muestra si includePerformanceInfo es verdadero. Redondeamos los bytes procesados a MB y, luego, los convertimos en bytes. -1 significa que no se pudo recuperar para esta consulta.

queryPerformanceInfo

object (QueryPerformanceInfo)

Se muestra si includePerformanceInfo es verdadero.

filteredRowSummary

object (FilteredRowSummary)

Resumen de filas filtradas que se usaría cuando se ejecute la consulta: las filas que no están lo suficientemente agregadas se eliminan del resultado y resumen de filas filtradas describe cómo resumir estas filas. Para obtener más detalles, consulte https://developers.google.com/ads-data-hub/guides/filtered-row-summary.

Alcances de la autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/adsdatahub