Ads Data Hub API

API برای اجرای جستجوهای Ads Data Hub.

خدمات: adsdatahub.googleapis.com

برای تماس با این سرویس، توصیه می کنیم از کتابخانه های سرویس گیرنده ارائه شده توسط Google استفاده کنید. اگر برنامه شما نیاز به استفاده از کتابخانه های خود برای فراخوانی این سرویس دارد، هنگام درخواست API از اطلاعات زیر استفاده کنید.

سند کشف

Discovery Document یک ویژگی قابل خواندن توسط ماشین برای توصیف و مصرف API های REST است. از آن برای ساخت کتابخانه های سرویس گیرنده، پلاگین های IDE و سایر ابزارهایی که با Google API در تعامل هستند استفاده می شود. یک سرویس ممکن است چندین سند کشف را ارائه دهد. این سرویس سند کشف زیر را ارائه می دهد:

نقطه پایان خدمات

نقطه پایانی سرویس یک URL پایه است که آدرس شبکه یک سرویس API را مشخص می کند. یک سرویس ممکن است چندین نقطه پایانی سرویس داشته باشد. این سرویس دارای نقطه پایانی سرویس زیر است و همه URI های زیر مربوط به این نقطه پایانی سرویس هستند:

  • https://adsdatahub.googleapis.com

منبع REST: v1.customers

مواد و روش ها
describeValidDv360AdvertiserIds POST /v1/{customer=customers/*}:describeValidDv360AdvertiserIds
شناسه‌های تبلیغ‌کننده معتبر DV360 را توصیف می‌کند
describeValidFrequencyLimitingEventMatchers GET /v1/{customer=customers/*}:describeValidFrequencyLimitingEventMatchers
تطبیق‌های رویداد معتبر را همراه با فراداده‌های آن‌ها برای محدود کردن فرکانس فهرست‌های مخاطبان فهرست می‌کند.
exportJobHistory POST /v1/{customer=customers/*}:exportJobHistory
سابقه شغلی یک حساب مشتری را به مجموعه داده BigQuery انتخاب شده توسط مشتری صادر می کند.
generateDv360IvtVideoViewabilityReport POST /v1/{customer=customers/*}:generateDv360IvtVideoViewabilityReport
اجرای یک پرس و جو را برای بازیابی معیارهای مشاهده پذیری ترافیک نامعتبر برای پلت فرم DV360 آغاز می کند.
generateIvtReport POST /v1/{name=customers/*}:generateIvtReport
اجرای یک پرس و جو را برای بازیابی خلاصه روزانه از تعداد ترافیک نامعتبر برای یک پلت فرم خاص شروع می کند.
get GET /v1/{name=customers/*}
مشتری Ads Data Hub درخواستی را بازیابی می کند.
getImportCompletionStatus GET /v1/{customer=customers/*}/importCompletionStatus
درصدی از داده‌های Google را در همه مشتریانی که در تاریخ معین با موفقیت وارد ADH شده‌اند، برمی‌گرداند.
list GET /v1/customers
مشتریان Ads Data Hub را فهرست می کند که کاربر فعلی به آنها دسترسی دارد.

منبع REST: v1.customers.adsDataCustomers

مواد و روش ها
get GET /v1/{name=customers/*/adsDataCustomers/*}
مشتری Ads Data Hub درخواستی را بازیابی می کند.
getDataAccessBudget GET /v1/{name=customers/*/adsDataCustomers/*/dataAccessBudget}
بودجه دسترسی به داده را برای منبع داده تبلیغات درخواستی برای 366 روز گذشته بازیابی می کند.
list GET /v1/{parent=customers/*}/adsDataCustomers
مشتریان داده های تبلیغاتی را فهرست می کند که از مشتری قابل دسترسی هستند.

منبع REST: v1.customers.analysisQueries

مواد و روش ها
create POST /v1/{parent=customers/*}/analysisQueries
یک کوئری تجزیه و تحلیل برای اجرای بعدی ایجاد می کند.
delete DELETE /v1/{name=customers/*/analysisQueries/*}
یک جستار تجزیه و تحلیل را حذف می کند.
get GET /v1/{name=customers/*/analysisQueries/*}
پرسش تحلیل درخواستی را بازیابی می کند.
list GET /v1/{parent=customers/*}/analysisQueries
پرس و جوهای تجزیه و تحلیل متعلق به مشتری مشخص را فهرست می کند.
patch PATCH /v1/{query.name=customers/*/analysisQueries/*}
یک پرسش تحلیل موجود را به روز می کند.
start POST /v1/{name=customers/*/analysisQueries/*}:start
اجرا را روی یک کوئری تحلیلی ذخیره شده شروع می کند.
startTransient POST /v1/{parent=customers/*}/analysisQueries:startTransient
اجرا را روی یک کوئری تحلیل گذرا شروع می کند.
validate POST /v1/{parent=customers/*}/analysisQueries:validate
بررسی های اعتبارسنجی ایستا را در پرس و جوی تحلیل ارائه شده انجام می دهد.

منبع REST: v1.customers.customBiddingAlgorithms

مواد و روش ها
addAdvertiser POST /v1/{customBiddingAlgorithm=customers/*/customBiddingAlgorithms/*}:addAdvertiser
یک تبلیغ‌کننده DV360 را به تبلیغ‌کنندگان الگوریتم مناقصه سفارشی اضافه کنید.
create POST /v1/{parent=customers/*}/customBiddingAlgorithms
یک الگوریتم مناقصه سفارشی مدیریت شده توسط Ads Data Hub ایجاد می کند.
delete DELETE /v1/{name=customers/*/customBiddingAlgorithms/*}
این الگوریتم پیشنهاد سفارشی را حذف کنید.
execute POST /v1/{name=customers/*/customBiddingAlgorithms/*}:execute
امتیازات 30 روز گذشته نمایش‌ها را برای مدل‌های پیشنهادی سفارشی کسب می‌کند.
get GET /v1/{name=customers/*/customBiddingAlgorithms/*}
الگوریتم پیشنهادی سفارشی مدیریت شده توسط Ads Data Hub را بازیابی می کند.
list GET /v1/{parent=customers/*}/customBiddingAlgorithms
الگوریتم های مناقصه سفارشی که توسط مشتری Ads Data Hub مشخص شده مدیریت می شود را فهرست می کند.
patch PATCH /v1/{customBiddingAlgorithm.name=customers/*/customBiddingAlgorithms/*}
الگوریتم پیشنهادی سفارشی مدیریت شده توسط Ads Data Hub درخواستی را به روز می کند.
removeAdvertiser POST /v1/{customBiddingAlgorithm=customers/*/customBiddingAlgorithms/*}:removeAdvertiser
یک تبلیغ‌کننده DV360 را از تبلیغ‌کنندگان الگوریتم مناقصه سفارشی حذف کنید.

منبع REST: v1.customers.tables

مواد و روش ها
get GET /v1/{name=customers/*/tables/*}
جدول Ads Data Hub درخواستی را بازیابی می کند.
list GET /v1/{parent=customers/*}/tables
جداول Ads Data Hub را فهرست می کند که مشتری مشخص شده به آنها دسترسی دارد.

منبع REST: v1.customers.tempTables

مواد و روش ها
get GET /v1/{name=customers/*/tempTables/*}
جدول زمانی Ads Data Hub درخواستی را بازیابی می کند.
list GET /v1/{parent=customers/*}/tempTables
جداول موقت Ads Data Hub را که مشتری ایجاد کرده است فهرست می کند.

منبع REST: v1.customers.userListQueries

مواد و روش ها
create POST /v1/{parent=customers/*}/userListQueries
یک پرس و جو لیست کاربر را برای اجرای بعدی ایجاد می کند.
delete DELETE /v1/{name=customers/*/userListQueries/*}
یک پرس و جو لیست کاربر را حذف می کند.
get GET /v1/{name=customers/*/userListQueries/*}
پرس و جو لیست کاربر درخواستی را بازیابی می کند.
list GET /v1/{parent=customers/*}/userListQueries
پرس و جوهای فهرست کاربران متعلق به مشتری مشخص را فهرست می کند.
patch PATCH /v1/{query.name=customers/*/userListQueries/*}
یک جستجوی لیست کاربر موجود را به روز می کند.
start POST /v1/{name=customers/*/userListQueries/*}:start
اجرا را در یک پرس و جو لیست کاربر ذخیره شده شروع می کند.
startTransient
(deprecated)		 POST /v1/{parent=customers/*}/userListQueries:startTransient
اجرا را در یک پرس و جو لیست کاربر گذرا شروع می کند.
validate POST /v1/{parent=customers/*}/userListQueries:validate
بررسی های اعتبارسنجی ایستا را در پرس و جو لیست کاربر ارائه شده انجام می دهد.

منبع REST: v1.customers.userLists

مواد و روش ها
addEventMatchers POST /v1/{userList=customers/*/userLists/*}:addEventMatchers
تطبیق رویدادها را به لیست کاربران مبتنی بر فرکانس اضافه می کند.
addRecipients POST /v1/{userList=customers/*/userLists/*}:addRecipients
موجودیت ها را به گیرندگان لیست کاربران مدیریت شده توسط Ads Data Hub اضافه کنید.
create POST /v1/{parent=customers/*}/userLists
یک لیست کاربران مدیریت شده توسط Ads Data Hub ایجاد می کند.
delete DELETE /v1/{name=customers/*/userLists/*}
لیست کاربران مدیریت شده Ads Data Hub درخواستی را حذف کنید.
generateFrequencyListMemberships POST /v1/{name=customers/*/userLists/*}:generateFrequencyListMemberships
ایجاد عضویت برای UserList.
get GET /v1/{name=customers/*/userLists/*}
لیست کاربران مدیریت شده توسط Ads Data Hub درخواستی را بازیابی می کند.
list GET /v1/{parent=customers/*}/userLists
فهرست‌های کاربرانی را که توسط مشتری Ads Data Hub مدیریت می‌شوند، فهرست می‌کند.
patch PATCH /v1/{userList.name=customers/*/userLists/*}
لیست کاربران مدیریت شده توسط Ads Data Hub درخواستی را به روز می کند.
removeRecipients POST /v1/{userList=customers/*/userLists/*}:removeRecipients
موجودیت ها را از گیرندگان لیست کاربر مدیریت شده توسط Ads Data Hub حذف می کند.

منبع REST: v1.operations

مواد و روش ها
cancel POST /v1/{name=operations/**}:cancel
لغو ناهمزمان را در یک عملیات طولانی مدت شروع می کند.
delete DELETE /v1/{name=operations/**}
یک عملیات طولانی مدت را حذف می کند.
get GET /v1/{name=operations/**}
آخرین وضعیت یک عملیات طولانی مدت را دریافت می کند.
list GET /v1/{name}
عملیاتی را فهرست می کند که با فیلتر مشخص شده در درخواست مطابقت دارند.
wait POST /v1/{name=operations/**}:wait
صبر می کند تا عملیات طولانی مدت مشخص شده انجام شود یا حداکثر به یک بازه زمانی مشخص برسد و آخرین حالت را برمی گرداند.

منبع REST: v1.outages

مواد و روش ها
list GET /v1/outages
خاموشی ها را به ترتیب نزولی از مهر زمانی شروع خاموشی فهرست می کند و پنجره نگاه به عقب 130 روز است.