Method: customers.analysisQueries.start

اجرا را روی یک کوئری تحلیل ذخیره شده شروع می کند. نتایج در جدول مقصد BigQuery مشخص شده نوشته می شود. نام عملیات بازگشتی را می توان برای نظرسنجی وضعیت تکمیل پرس و جو استفاده کرد.

درخواست HTTP

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

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

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

مولفه های
name

string

نام کامل منبع، به عنوان مثال «customers/123/analysisQueries/abcd1234».

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "spec": {
    object (QueryExecutionSpec)
  },
  "destTable": string,
  "customerId": string
}
زمینه های
spec

object ( QueryExecutionSpec )

پارامترهای اجرای پرس و جو را تعریف می کند.

destTable

string

جدول مقصد BigQuery برای نتایج پرس و جو با قالب «project.dataset.table_name». اگر مشخص شده باشد، پروژه باید به صراحت برای حساب ADH مشتری در لیست سفید قرار گیرد. اگر پروژه مشخص نشده باشد، از پروژه پیش فرض برای مشتری ارائه شده استفاده می کند. اگر نه پروژه و نه مجموعه داده مشخص نشده است، از پروژه و مجموعه داده پیش فرض استفاده می کند.

customerId

string ( int64 format)

اختیاری. مشتری Ads Data Hub در حال اجرای پرس و جو. اگر مشخص نشده باشد، به طور پیش‌فرض به مشتری صاحب پرس و جو می‌شود.

بدن پاسخگو

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

محدوده مجوز

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

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