اجرای یک پرس و جو را برای بازیابی معیارهای مشاهده پذیری ترافیک نامعتبر برای پلت فرم DV360 آغاز می کند. نتایج در جدول مقصد BigQuery مشخص شده نوشته می شود. نام عملیات بازگشتی را می توان برای نظرسنجی وضعیت تکمیل پرس و جو استفاده کرد.
درخواست HTTP
POST https://adsdatahub.googleapis.com/v1/{customer=customers/*}:generateDv360IvtVideoViewabilityReport
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
customer | مشتری Ads Data Hub درخواست را ارائه می دهد. این به شکل 'customers/[customerId]' است. به عنوان مثال 'مشتریان/123'. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "adsDataCustomerId": string, "startDate": { object ( |
زمینه های | |
---|---|
adsDataCustomerId | شناسه مشتری مرکز داده آگهیهای پیوندی که مالک دادههای تبلیغات است. |
startDate | روز اول گزارش تولید شده |
endDate | آخرین روز گزارش تولید شده، شامل. |
timeZone | منطقه زمانی برای تاریخ شروع و پایان گزارش. اگر مشخص نشده باشد، پیشفرض «UTC» است. |
lineItemIds[] | شناسه آیتم های خطی برای گزارش. |
destTable | جدول مقصد BigQuery برای نتایج پرس و جو با قالب «project.dataset.table_name». اگر مشخص شده باشد، پروژه باید به صراحت برای حساب ADH مشتری در لیست سفید قرار گیرد. اگر پروژه مشخص نشده باشد، از پروژه پیش فرض برای مشتری ارائه شده استفاده می کند. اگر نه پروژه و نه مجموعه داده مشخص نشده است، از پروژه و مجموعه داده پیش فرض استفاده می کند. |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Operation
است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/adsdatahub
اجرای یک پرس و جو را برای بازیابی معیارهای مشاهده پذیری ترافیک نامعتبر برای پلت فرم DV360 آغاز می کند. نتایج در جدول مقصد BigQuery مشخص شده نوشته می شود. نام عملیات بازگشتی را می توان برای نظرسنجی وضعیت تکمیل پرس و جو استفاده کرد.
درخواست HTTP
POST https://adsdatahub.googleapis.com/v1/{customer=customers/*}:generateDv360IvtVideoViewabilityReport
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
customer | مشتری Ads Data Hub درخواست را ارائه می دهد. این به شکل 'customers/[customerId]' است. به عنوان مثال 'مشتریان/123'. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "adsDataCustomerId": string, "startDate": { object ( |
زمینه های | |
---|---|
adsDataCustomerId | شناسه مشتری مرکز داده آگهیهای پیوندی که مالک دادههای تبلیغات است. |
startDate | روز اول گزارش تولید شده |
endDate | آخرین روز گزارش تولید شده، شامل. |
timeZone | منطقه زمانی برای تاریخ شروع و پایان گزارش. اگر مشخص نشده باشد، پیشفرض «UTC» است. |
lineItemIds[] | شناسه آیتم های خطی برای گزارش. |
destTable | جدول مقصد BigQuery برای نتایج پرس و جو با قالب «project.dataset.table_name». اگر مشخص شده باشد، پروژه باید به صراحت برای حساب ADH مشتری در لیست سفید قرار گیرد. اگر پروژه مشخص نشده باشد، از پروژه پیش فرض برای مشتری ارائه شده استفاده می کند. اگر هیچ پروژه و مجموعه داده مشخص نشده باشد، از پروژه و مجموعه داده پیش فرض استفاده می کند. |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Operation
است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/adsdatahub