يبدأ تنفيذ طلب بحث لاسترداد مقاييس إمكانية عرض الزيارات غير الصالحة للنظام الأساسي في "مساحة العرض والفيديو 360". ستتم كتابة النتائج في جدول وجهة BigQuery المحدّدة. ويمكن استخدام اسم العملية المعروضة لاستطلاع حالة اكتمال طلب البحث.
طلب HTTP
POST https://adsdatahub.googleapis.com/v1/{customer=customers/*}:generateDv360IvtVideoViewabilityReport
يستخدم عنوان URL بنية gRPC Transcoding.
معلّمات المسار
المَعلمات | |
---|---|
customer |
عميل Ads Data Hub الذي يقدّم الطلب. ويظهر هذا في شكل #&39;customers/[customerId]'. على سبيل المثال: 'customers/123'. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "adsDataCustomerId": string, "startDate": { object ( |
الحقول | |
---|---|
adsDataCustomerId |
الرقم التعريفي لعميل Ads Data Hub المرتبط ببيانات الإعلانات. |
startDate |
اليوم الأول من التقرير الذي تم إنشاؤه. |
endDate |
اليوم الأخير من التقرير الذي تم إنشاؤه، شاملاً. |
timeZone |
المنطقة الزمنية لتقريرَي تاريخ البدء وانتهائه. إذا لم يتم تحديدها، سيتم ضبطها تلقائيًا على 'UTC'. |
lineItemIds[] |
أرقام تعريف العناصر لإعداد تقارير عنها |
destTable |
جدول BigQuery المقصود لنتائج طلب البحث بالتنسيق 'project.dataset.table_name' إذا تم تحديد المشروع، يجب أن يكون قد تمت إضافة المشروع إلى القائمة البيضاء بشكلٍ صريح لحساب Ads Data Hub للعميل. إذا لم يتم تحديد المشروع، سيتم استخدام المشروع التلقائي للعميل الذي تم تقديمه. إذا لم يتم تحديد أي من المشروع أو مجموعة البيانات، يتم استخدام المشروع ومجموعة البيانات التلقائيتين. |
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Operation
.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/adsdatahub