REST Resource: customers.analysisQueries

Recurso: AnalysisQuery

Define una consulta de análisis que se puede ejecutar en el CDA.

Representación JSON 
{
  "name": string,
  "title": string,
  "queryText": string,
  "parameterTypes": {
    string: {
      object (ParameterType)
    },
    ...
  },
  "mergeSpec": {
    object (MergeSpec)
  },
  "queryState": enum (QueryState),
  "updateTime": string,
  "updateEmail": string,
  "createTime": string,
  "createEmail": string,
  "queryShare": [
    {
      object (QueryShare)
    }
  ],

  // Union field filtered_row can be only one of the following:
  "filteredRowSummary": {
    object (FilteredRowSummary)
  },
  "generateFilteredRowSummaryAutomatically": boolean
  // End of list of possible types for union field filtered_row.
}
Campos
name

string

Nombre que identifica de forma única una consulta. Tiene el formato customers/[customerId]/analysisQueries/[resource_id], p.ej., 'customers/123/analysisQueries/abcd1234'. El servidor genera el ID de recurso.
title

string

Título de la consulta, que es único dentro de un único cliente de Ads Data Hub y tipo de consulta
queryText

string

Texto de consulta escrito en SQL estándar Consulte https://cloud.google.com/bigquery/docs/reference/standard-sql/.
parameterTypes

map (key: string, value: object (ParameterType))

Cualquier parámetro adicional que espere la consulta. Asigna cada nombre de argumento a su tipo de argumento.

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
mergeSpec
(deprecated)

object (MergeSpec)

Instrucciones para la combinación de filas Si están presentes, las filas que se habrían descartado por razones de privacidad se combinarán en una sola fila combinada. La fila combinada estará en el resultado final si la fila combinada cumple con los requisitos de privacidad.
queryState

enum (QueryState)

Estado de la consulta.
updateTime

string (Timestamp format)

Hora en que se actualizó por última vez la consulta.

Una marca de tiempo en formato RFC3339 UTC (Zulú) con resolución en nanosegundos y hasta nueve dígitos decimales. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
updateEmail

string

Dirección de correo electrónico del usuario que actualizó la consulta por última vez.
createTime

string (Timestamp format)

Hora en que se creó la consulta.

Una marca de tiempo en formato RFC3339 UTC (Zulú) con resolución en nanosegundos y hasta nueve dígitos decimales. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
createEmail

string

Dirección de correo electrónico del usuario que creó la consulta.
queryShare[]

object (QueryShare)

Indica formas en las que se puede compartir una consulta más allá del cliente propietario del Centro de Datos de Anuncios.
Campo de unión filtered_row. Instrucciones para la combinación de filas Las direcciones (filtered_row) solo pueden ser una de las siguientes opciones:
filteredRowSummary

object (FilteredRowSummary)

Define cómo combinar las filas eliminadas por razones de privacidad en una sola fila combinada. La fila combinada se incluirá en el resultado final si la fila combinada cumple con los requisitos de privacidad.
generateFilteredRowSummaryAutomatically

boolean

Si es verdadero, se genera automáticamente un resumen de fila filtrado.

MergeSpec.

Combina instrucciones para un esquema de resultados de consulta de análisis.

Representación JSON 
{
  "columns": {
    string: {
      object (MergeColumn)
    },
    ...
  }
}
Campos
columns

map (key: string, value: object (MergeColumn))

Instrucciones para combinar cada columna, codificadas por nombre Las columnas faltantes se tratarán como MERGE_TYPE_UNSPECIFIED.

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

MergeColumn

Instrucciones de fusión para una sola columna de resultado.

Representación JSON 
{
  "type": enum (MergeType),
  "value": {
    object (ParameterValue)
  }
}
Campos
type

enum (MergeType)

Método utilizado para combinar los valores de la columna.
value

object (ParameterValue)

El valor constante que se usará (solo válido para el tipo de combinación CONSTANT).

Tipo de combinación

Todas las operaciones admitidas para la combinación de columnas

Enumeradores
MERGE_TYPE_UNSPECIFIED Tipo de combinación no especificado. El valor de la columna combinada será NULL.
CONSTANT Reemplaza el valor de la columna combinada por la constante determinada.
SUM Toma la suma de los valores de columna combinados.

Resumen de filas filtradas

Combina instrucciones para un esquema de resultados de consulta de análisis.

Representación JSON 
{
  "columns": {
    string: {
      object (ColumnSummaryRule)
    },
    ...
  }
}
Campos
columns

map (key: string, value: object (ColumnSummaryRule))

Instrucciones para combinar cada columna, codificadas por nombre Las columnas faltantes se tratarán como SUMMARY_TYPE_UNSPECIFIED.

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Regla de resumen de columnas

Instrucciones de fusión para una sola columna de resultado.

Representación JSON 
{
  "type": enum (SummaryType),
  "value": {
    object (ParameterValue)
  }
}
Campos
type

enum (SummaryType)

Método utilizado para combinar los valores de la columna.
value

object (ParameterValue)

El valor constante que se usará (solo válido para el tipo de resumen CONSTANT).

Tipo de resumen

Todas las operaciones admitidas para la combinación de columnas

Enumeradores
SUMMARY_TYPE_UNSPECIFIED Tipo de resumen sin especificar. El valor de la columna de resumen será NULL.
CONSTANT Reemplaza el valor de la columna combinada por la constante determinada.
SUM Toma la suma de los valores de columna combinados.

Métodos

create

 Crea una consulta de análisis para su ejecución posterior.

delete

 Borra una consulta de análisis.

get

 Recupera la consulta de análisis solicitada.

list

 Enumera las consultas de análisis que pertenecen al cliente especificado.

patch

 Actualiza una consulta de análisis existente.

start

 Inicia la ejecución en una consulta de análisis almacenada.

startTransient

 Inicia la ejecución en una consulta de análisis transitoria.

validate

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