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 لتجفيف طلب البحث لجمع بعض معلومات الأداء. وقد يستغرق الأمر وقتًا أطول مقارنةً بالتحقق من صحة طلب البحث فقط. يجب ضبط تاريخ البدء وتاريخ الانتهاء والمعلَمات داخل query_execution_spec للتشغيل التجريبي.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

الرد على طلبanalyticsQuery.valid.

تمثيل JSON
{
  "processedBytes": string,
  "queryPerformanceInfo": {
    object (QueryPerformanceInfo)
  },
  "filteredRowSummary": {
    object (FilteredRowSummary)
  }
}
الحقول
processedBytes
(deprecated)

string (int64 format)

متوقف، واستخدام queryالأداءInfo بدلاً من ذلك. وحدات بايت للبيانات التي يقرأها طلب البحث هذا. يُرجى الاطّلاع على https://cloud.google.com/bigquery/pricing#data للحصول على تفاصيل عن كيفية حساب ذلك. يتم العرض إذا كان IncludeالأداءInfo صحيحًا. يتم تقريب وحدات البايت التي تمت معالجتها إلى ميغابايت، ثم تحويلها إلى بايت. -1 يعني أننا لم نتمكن من جلبه لهذا الطلب.

queryPerformanceInfo

object (QueryPerformanceInfo)

يتم العرض إذا كان IncludeالأداءInfo صحيحًا.

filteredRowSummary

object (FilteredRowSummary)

ملخّص الصفوف التي تمت فلترتها والذي سيتم استخدامه عند تنفيذ طلب البحث: يتم إسقاط الصفوف غير المجمَّعة بشكل كافٍ من النتيجة، ويصف ملخّص الصفوف الذي تمت تصفيته كيفية تلخيص هذه الصفوف. وللحصول على التفاصيل، يُرجى الاطّلاع على https://developers.google.com/ads-data-hub/guides/filtered-row-summary.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

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