Method: customers.analysisQueries.start

يبدأ التنفيذ على طلب تحليل مُخزَّن. ستتم كتابة النتائج في جدول وجهة BigQuery المحدّدة. ويمكن استخدام اسم العملية المعروضة لاستطلاع حالة اكتمال طلب البحث.

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcoding.

معلّمات المسار

المَعلمات
name

string

اسم المورد الكامل، على سبيل المثال 'customers/123/analysisQuries/abcd1234&#39؛

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "spec": {
    object (QueryExecutionSpec)
  },
  "destTable": string,
  "customerId": string
}
الحقول
spec

object (QueryExecutionSpec)

تحديد معلمات تنفيذ طلب البحث.
destTable

string

جدول BigQuery المقصود لنتائج طلب البحث بالتنسيق 'project.dataset.table_name' إذا تم تحديد المشروع، يجب أن يكون قد تمت إضافة المشروع إلى القائمة البيضاء بشكلٍ صريح لحساب Ads Data Hub للعميل. إذا لم يتم تحديد المشروع، سيتم استخدام المشروع التلقائي للعميل الذي تم تقديمه. إذا لم يتم تحديد أي من المشروع أو مجموعة البيانات، يتم استخدام المشروع ومجموعة البيانات التلقائيتين.
customerId

string (int64 format)

اختياريّ. ينفّذ عميل Ads Data Hub طلب البحث. إذا لم يتم تحديد القيمة، سيتم ضبطها تلقائيًا على العميل الذي يملك طلب البحث.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Operation.

نطاقات التفويض

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

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