REST Resource: customers.analysisQueries

Risorsa: AnalysisQuery

Definisce una query di analisi che può essere eseguita in Ads Data Hub.

Rappresentazione 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.
}
Campi
name

string

Nome che identifica in modo univoco una query. Il formato è customer/[customerId]/analysis Queries/[resource_id], ad es. 'customers/123/analysisQuery/abcd1234'. L'ID risorsa è generato dal server.
title

string

Titolo della query univoco per cliente e tipo di query di Ads Data Hub.
queryText

string

Testo della query scritto in SQL standard. Consulta la pagina https://cloud.google.com/bigquery/docs/reference/standard-sql/.
parameterTypes

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

Eventuali parametri aggiuntivi previsti dalla query. Mappa il nome di ogni argomento al relativo tipo di argomento.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
mergeSpec
(deprecated)

object (MergeSpec)

Istruzioni per l'unione di righe. Se presente, le righe che sarebbero state eliminate per motivi di privacy verranno combinate in una singola riga unita. La riga unita sarà nell'output finale se la riga unita soddisfa i requisiti per la privacy.
queryState

enum (QueryState)

Stato della query.
updateTime

string (Timestamp format)

L'ora dell'ultimo aggiornamento della query.

Un timestamp in formato RFC3339 UTC "Zulu", con una risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
updateEmail

string

Indirizzo email dell'utente che ha aggiornato la query l'ultima volta.
createTime

string (Timestamp format)

L'ora in cui è stata creata la query.

Un timestamp in formato RFC3339 UTC "Zulu", con una risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
createEmail

string

Indirizzo email dell'utente che ha creato la query.
queryShare[]

object (QueryShare)

Indica modi in cui una query può essere condivisa oltre il proprietario del cliente Ads Data Hub.
Campo unione filtered_row. Istruzioni per l'unione di righe. filtered_row può essere solo uno dei seguenti:
filteredRowSummary

object (FilteredRowSummary)

Definisci come combinare le righe eliminate per motivi di privacy in un'unica riga unita. La riga unita sarà inclusa nell'output finale se la riga unita soddisfa i requisiti per la privacy.
generateFilteredRowSummaryAutomatically

boolean

Se true, viene generato automaticamente un riepilogo della riga filtrata.

UnisciSpec

Unisci le istruzioni per uno schema di risultati della query di analisi.

Rappresentazione JSON 
{
  "columns": {
    string: {
      object (MergeColumn)
    },
    ...
  }
}
Campi
columns

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

Istruzioni per l'unione di ciascuna colonna, chiave per nome. Eventuali colonne mancanti verranno trattate come AJAX_TYPE_UNSPECIFIED.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Colonna Unisci

Istruzioni di unione per una singola colonna di output.

Rappresentazione JSON 
{
  "type": enum (MergeType),
  "value": {
    object (ParameterValue)
  }
}
Campi
type

enum (MergeType)

Metodo utilizzato per combinare i valori della colonna.
value

object (ParameterValue)

Il valore costante da utilizzare (valido solo per il tipo di unione CONSTANT).

TipoUnisci

Tutte le operazioni supportate per l'unione di colonne.

Enum
MERGE_TYPE_UNSPECIFIED Tipo di unione non specificato. Il valore della colonna unita sarà NULL.
CONSTANT Sostituisci il valore della colonna unita con la costante specificata.
SUM Prendi la somma dei valori delle colonne unite.

RiepilogoRiga filtrata

Unisci le istruzioni per uno schema di risultati della query di analisi.

Rappresentazione JSON 
{
  "columns": {
    string: {
      object (ColumnSummaryRule)
    },
    ...
  }
}
Campi
columns

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

Istruzioni per l'unione di ciascuna colonna, chiave per nome. Eventuali colonne mancanti verranno trattate come INDEX_TYPE_UNSPECIFIED.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

RegolaRegolaRiepilogo

Istruzioni di unione per una singola colonna di output.

Rappresentazione JSON 
{
  "type": enum (SummaryType),
  "value": {
    object (ParameterValue)
  }
}
Campi
type

enum (SummaryType)

Metodo utilizzato per combinare i valori della colonna.
value

object (ParameterValue)

Il valore costante da utilizzare (valido solo per il tipo di riepilogo COSTANTE).

TipoRiepilogo

Tutte le operazioni supportate per l'unione di colonne.

Enum
SUMMARY_TYPE_UNSPECIFIED Tipo di riepilogo non specificato. Il valore della colonna di riepilogo sarà NULL.
CONSTANT Sostituisci il valore della colonna unita con la costante specificata.
SUM Prendi la somma dei valori delle colonne unite.

Metodi

create

 Crea una query di analisi per l'esecuzione successiva.

delete

 Elimina una query di analisi.

get

 Recupera la query di analisi richiesta.

list

 Elenca le query di analisi di proprietà del cliente specificato.

patch

 Aggiorna una query di analisi esistente.

start

 Avvia l'esecuzione su una query di analisi archiviata.

startTransient

 Avvia l'esecuzione su una query di analisi temporanea.

validate

 Esegue controlli di convalida statici sulla query di analisi fornita.