Method: customers.analysisQueries.validate

Effectue des contrôles de validation statique sur la requête d'analyse fournie.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Nom de la ressource parente qui détient la requête, par exemple 'customers/123'.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON
{
  "query": {
    object (AnalysisQuery)
  },
  "adsDataCustomerId": string,
  "matchDataCustomerId": string,
  "spec": {
    object (QueryExecutionSpec)
  },
  "includePerformanceInfo": boolean
}
Champs
query

object (AnalysisQuery)

Requête à valider.

adsDataCustomerId
(deprecated)

string (int64 format)

Facultatif. Numéro client Ads Data Hub associé à utiliser pour valider les données des annonces et l'accès au tableau temporaire. La valeur par défaut est "Tous les clients associés". Obsolète. Utilisez adsDataCustomerId dans query_execution_spec.

matchDataCustomerId
(deprecated)

string (int64 format)

Facultatif. Numéro client Ads Data Hub associé spécifique à utiliser pour valider les données de correspondance et l'accès au tableau temporaire. La valeur par défaut est "Tous les clients associés". Obsolète. Utilisez le match_table_customer_id dans query_execution_spec.

spec

object (QueryExecutionSpec)

Facultatif. Les champs dupliqués dans query_execution_spec remplaceront les champs externes.

includePerformanceInfo

boolean

Facultatif. Si vous obtenez la valeur "true", appelez BigQuery pour exécuter la requête afin de collecter des informations sur les performances. Cette opération peut prendre plus de temps qu'une validation de la requête. Les valeurs startDate et endDate ainsi que les paramètres de query_execution_spec doivent être définis pour la simulation.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Réponse à une requête analyticsQuery.validate.

Représentation JSON
{
  "processedBytes": string,
  "queryPerformanceInfo": {
    object (QueryPerformanceInfo)
  },
  "filteredRowSummary": {
    object (FilteredRowSummary)
  }
}
Champs
processedBytes
(deprecated)

string (int64 format)

Obsolète. Utilisez queryPerformanceInfo à la place. Octets de données lus par cette requête. Pour en savoir plus sur le calcul, consultez la page https://cloud.google.com/bigquery/pricing#data. Est renvoyé si "includePerformanceInfo" est défini sur "true". Nous arrondissons les Octets traités à Mo, puis nous les convertissons en octets. -1 signifie que nous n'avons pas pu l'extraire pour cette requête.

queryPerformanceInfo

object (QueryPerformanceInfo)

Est renvoyé si "includePerformanceInfo" est défini sur "true".

filteredRowSummary

object (FilteredRowSummary)

Résumé des lignes filtrées utilisé lors de l'exécution de la requête: les lignes qui ne sont pas suffisamment agrégées sont supprimées du résultat. Le résumé des lignes filtrées décrit comment synthétiser ces lignes. Pour en savoir plus, consultez la page https://developers.google.com/ads-data-hub/guides/filtered-row-summary.

Champs d'application des autorisations

Requiert le champ d'application OAuth suivant :

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