Method: customers.analysisQueries.validate

Выполняет статическую проверку достоверности предоставленного запроса анализа.

HTTP-запрос

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

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
parent

string

Имя родительского ресурса, которому принадлежит запрос, например «customers/123».

Тело запроса

Тело запроса содержит данные со следующей структурой:

Представление JSON
{
  "query": {
    object (AnalysisQuery)
  },
  "adsDataCustomerId": string,
  "matchDataCustomerId": string,
  "spec": {
    object (QueryExecutionSpec)
  },
  "includePerformanceInfo": boolean
}
Поля
query

object ( AnalysisQuery )

Запрос для проверки.

adsDataCustomerId
(deprecated)

string ( int64 format)

По желанию. Конкретный связанный идентификатор клиента Ads Data Hub, который будет использоваться для проверки данных объявлений и доступа к временным таблицам. По умолчанию для всех связанных клиентов. Устарело. Используйте adsDataCustomerId внутри query_execution_spec.

matchDataCustomerId
(deprecated)

string ( int64 format)

По желанию. Конкретный связанный идентификатор клиента Ads Data Hub, который будет использоваться для проверки данных соответствия и доступа к временной таблице. По умолчанию для всех связанных клиентов. Устарело. Используйте match_table_customer_id внутри query_execution_spec.

spec

object ( QueryExecutionSpec )

По желанию. Дублированные поля внутри query_execution_spec переопределяют поля снаружи.

includePerformanceInfo

boolean

По желанию. Если это правда, вызовите BigQuery для пробного запуска запроса и сбора информации о производительности. Это может занять больше времени по сравнению с простой проверкой запроса. StartDate, endDate и параметры внутри query_execution_spec должны быть установлены для пробного прогона.

Тело ответа

В случае успеха тело ответа содержит данные со следующей структурой:

Ответ на запрос analysisQueries.validate.

Представление JSON
{
  "processedBytes": string,
  "queryPerformanceInfo": {
    object (QueryPerformanceInfo)
  },
  "filteredRowSummary": {
    object (FilteredRowSummary)
  }
}
Поля
processedBytes
(deprecated)

string ( int64 format)

Устарело, вместо этого используйте queryPerformanceInfo. Байты данных, которые читает этот запрос. См. https://cloud.google.com/bigquery/pricing#data для получения подробной информации о том, как это рассчитывается. Возвращается, если includePerformanceInfo имеет значение true. Мы округляем обрабатываемые байты до мегабайт, а затем конвертируем в байты. -1 означает, что мы не смогли получить его для этого запроса.

queryPerformanceInfo

object ( QueryPerformanceInfo )

Возвращается, если includePerformanceInfo имеет значение true.

filteredRowSummary

object ( FilteredRowSummary )

Сводка отфильтрованных строк, которая будет использоваться при выполнении запроса: строки, которые недостаточно агрегированы, удаляются из результата, сводка отфильтрованных строк описывает, как суммировать эти строки. Подробнее см. https://developers.google.com/ads-data-hub/guides/filtered-row-summary .

Области авторизации

Требуется следующая область действия OAuth:

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