Method: customers.analysisQueries.validate

Przeprowadza sprawdzanie statycznego zapytania.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Nazwa zasobu nadrzędnego, do którego należy zapytanie, np. 'customers/123'.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "query": {
    object (AnalysisQuery)
  },
  "adsDataCustomerId": string,
  "matchDataCustomerId": string,
  "spec": {
    object (QueryExecutionSpec)
  },
  "includePerformanceInfo": boolean
}
Pola
query

object (AnalysisQuery)

Zapytanie do weryfikacji.
adsDataCustomerId
(deprecated)

string (int64 format)

Opcjonalne. Identyfikator klienta połączonego Centrum danych reklam, który służy do weryfikowania danych reklam i dostępu do tabeli tymczasowej. Domyślnie są to połączone konta wszystkich klientów. Rola wycofana. Użyj parametru adsDataCustomerId wewnątrz query_execution_spec.
matchDataCustomerId
(deprecated)

string (int64 format)

Opcjonalne. Identyfikator połączonego klienta Centrum danych reklam, który służy do weryfikowania danych dopasowania i dostępu do tabeli tymczasowej. Domyślnie są to połączone konta wszystkich klientów. Rola wycofana. Użyj parametru match_table_customer_id w zapytaniu_execution_spec.
spec

object (QueryExecutionSpec)

Opcjonalne. Zduplikowane pola w zapytaniu query_execution_spec zastąpią pola na zewnątrz.
includePerformanceInfo

boolean

Opcjonalne. Jeśli wartość to prawda, wywołaj BigQuery, aby uruchomić zapytanie, aby zebrać informacje o wydajności. Może to potrwać dłużej niż samo sprawdzenie zapytania. W uruchomieniu próbnym należy ustawić parametry startDate, endDate i parametry w parametrze query_execution_spec.

Treść odpowiedzi

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Odpowiedź na parametrAnalizQuery.validate.

Zapis JSON 
{
  "processedBytes": string,
  "queryPerformanceInfo": {
    object (QueryPerformanceInfo)
  },
  "filteredRowSummary": {
    object (FilteredRowSummary)
  }
}
Pola
processedBytes
(deprecated)

string (int64 format)

Wycofana i zamiast niej użyj zapytania QueryPerformanceInfo. Bajty danych odczytywanych przez to zapytanie. Szczegółowe informacje na temat obliczania tych wartości znajdziesz na stronie https://cloud.google.com/bigquery/pricing#data. Zwraca wartość „true”, jeśli jest ustawiona wartość true (prawda). Zaokrąglamy dane przetworzoneBytes do MB, a następnie konwertujemy je na bajty. -1 oznacza, że nie udało się go pobrać w przypadku tego zapytania.
queryPerformanceInfo

object (QueryPerformanceInfo)

Zwraca wartość „true”, jeśli jest ustawiona wartość true (prawda).
filteredRowSummary

object (FilteredRowSummary)

Filtrowane podsumowanie wiersza, które zostanie użyte podczas wykonywania zapytania: wiersze, które nie są wystarczająco zagregowane, są usuwane z wyniku. Filtrowane podsumowanie wiersza opisuje sposób podsumowania tych wierszy. Szczegółowe informacje znajdziesz na https://developers.google.com/ads-data-hub/guides/filtered-row-summary.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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