Method: customers.analysisQueries.validate

بررسی های اعتبارسنجی ایستا را در پرس و جوی تحلیل ارائه شده انجام می دهد.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
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 باید برای اجرای خشک تنظیم شوند.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

پاسخ به یک درخواست AnalyticsQueries.validate.

نمایندگی JSON
{
  "processedBytes": string,
  "queryPerformanceInfo": {
    object (QueryPerformanceInfo)
  },
  "filteredRowSummary": {
    object (FilteredRowSummary)
  }
}
زمینه های
processedBytes
(deprecated)

string ( int64 format)

منسوخ شده است و به جای آن از queryPerformanceInfo استفاده کنید. بایت های داده ای که این پرس و جو می خواند. برای جزئیات نحوه محاسبه به https://cloud.google.com/bigquery/pricing#data مراجعه کنید. اگر includePerformanceInfo درست باشد، برگردانده می شود. ProcessedBytes را به مگابایت گرد می کنیم و سپس آن را به بایت تبدیل می کنیم. -1 به این معنی است که ما نتوانستیم آن را برای این جستار واکشی کنیم.

queryPerformanceInfo

object ( QueryPerformanceInfo )

اگر includePerformanceInfo درست باشد، برگردانده می شود.

filteredRowSummary

object ( FilteredRowSummary )

خلاصه ردیف فیلتر شده که هنگام اجرای پرس و جو استفاده می شود: ردیف هایی که به اندازه کافی انباشته نشده اند از نتیجه حذف می شوند، خلاصه ردیف فیلتر شده نحوه خلاصه کردن این ردیف ها را توضیح می دهد. برای جزئیات به https://developers.google.com/ads-data-hub/guides/filtered-row-summary مراجعه کنید.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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