Method: customers.analysisQueries.start

Démarre l'exécution d'une requête d'analyse stockée. Les résultats seront écrits dans la table de destination BigQuery spécifiée. Le nom d'opération renvoyé peut être utilisé pour interroger l'état d'avancement de la requête.

Requête HTTP

POST https://adsdatahub.googleapis.com/v1/{name=customers/*/analysisQueries/*}:start

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Nom complet de la ressource, par exemple 'customers/123/analysisqueries/abcd1234'.

Corps de la requête

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

Représentation JSON
{
  "spec": {
    object (QueryExecutionSpec)
  },
  "destTable": string,
  "customerId": string
}
Champs
spec

object (QueryExecutionSpec)

Définit les paramètres d'exécution de la requête.

destTable

string

Table BigQuery de destination pour les résultats de la requête au format 'project.dataset.table_name'. Si le projet est spécifié, il doit être explicitement ajouté à la liste blanche pour le compte ADH du client. Si le projet n'est pas spécifié, utilise le projet par défaut pour le client fourni. Si aucun projet ni ensemble de données n'est spécifié, utilise le projet et l'ensemble de données par défaut.

customerId

string (int64 format)

Facultatif. Client Ads Data Hub exécutant la requête. Si aucune valeur n'est spécifiée, la valeur par défaut correspond au client propriétaire de la requête.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Operation.

Niveaux d'accès des autorisations

Requiert le champ d'application OAuth suivant :

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