Method: customers.analysisQueries.start

Startet die Ausführung für eine gespeicherte Analyseabfrage. Die Ergebnisse werden in die angegebene BigQuery-Zieltabelle geschrieben. Der zurückgegebene Vorgangsname kann zum Abfragen des Abfrageabschlussstatus verwendet werden.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Vollständiger Ressourcenname, z. B. 'customers/123/analysisAbfragen/abcd1234'

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "spec": {
    object (QueryExecutionSpec)
  },
  "destTable": string,
  "customerId": string
}
Felder
spec

object (QueryExecutionSpec)

Definiert die Abfrageausführungsparameter.
destTable

string

BigQuery-Zieltabelle für Abfrageergebnisse im Format 'project.dataset.table_name' Falls angegeben, muss das Projekt explizit auf die Zulassungsliste für das ADH-Konto des Kunden gesetzt werden. Wenn das Projekt nicht angegeben ist, wird das Standardprojekt für den angegebenen Kunden verwendet. Wenn weder Projekt noch Dataset angegeben ist, werden das Standardprojekt und das Dataset verwendet.
customerId

string (int64 format)

Optional. Ads Data Hub-Kunde, der die Abfrage ausführt. Wenn keine Angabe erfolgt, wird standardmäßig der Kunde verwendet, dem die Abfrage gehört.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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