Method: customers.userListQueries.validate

Esegue controlli di convalida statici sulla query dell'elenco utenti fornita.

Richiesta HTTP

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

L'URL utilizza la sintassi gRPC Transcoding.

Parametri del percorso

Parametri
parent

string

Il nome della risorsa principale a cui appartiene la query, ad esempio 'customers/123'.

Corpo della richiesta

Il corpo della richiesta contiene i dati con la seguente struttura:

Rappresentazione JSON
{
  "query": {
    object (UserListQuery)
  },
  "adsDataCustomerId": string,
  "matchDataCustomerId": string,
  "spec": {
    object (QueryExecutionSpec)
  },
  "includePerformanceInfo": boolean
}
Campi
query

object (UserListQuery)

La query da convalidare.

adsDataCustomerId
(deprecated)

string (int64 format)

(Facoltativo) ID cliente Ads Data Hub collegato da utilizzare per convalidare l'accesso ai dati pubblicitari e alla tabella temporanea. Il valore predefinito è per tutti i clienti collegati. Deprecato. Utilizza adsDataCustomerId in query_execution_spec.

matchDataCustomerId
(deprecated)

string (int64 format)

(Facoltativo) ID cliente Ads Data Hub specifico da utilizzare per la convalida dei dati delle corrispondenze e dell'accesso alla tabella temporanea. Il valore predefinito è per tutti i clienti collegati. Deprecato. Utilizza il campo match_table_customer_id in query_execution_spec.

spec

object (QueryExecutionSpec)

(Facoltativo) I campi duplicati all'interno di query_execution_spec sostituiranno i campi esterni.

includePerformanceInfo

boolean

(Facoltativo) Se true, chiama BigQuery per eseguire la query in modo da raccogliere alcune informazioni sulle prestazioni. Potrebbe essere necessario più tempo rispetto alla convalida della query. I valori startDate, endDate e parametri all'interno di query_execution_spec devono essere impostati per la prova.

Corpo della risposta

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

Risposta a una richiesta userListQuery.validate.

Rappresentazione JSON
{
  "processedBytes": string,
  "queryPerformanceInfo": {
    object (QueryPerformanceInfo)
  }
}
Campi
processedBytes
(deprecated)

string (int64 format)

Ritirato e utilizza invece queryPerformanceInfo. Byte di dati letti da questa query. Consulta https://cloud.google.com/bigquery/pricing#data per i dettagli su come viene calcolato. Restituito se include PerformanceInfo. Arrotondamo i Byte elaborati in MB, quindi li convertiremo in byte. -1 significa che non è stato possibile recuperarlo per questa query.

queryPerformanceInfo

object (QueryPerformanceInfo)

Restituito se include PerformanceInfo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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