Ads Data Hub API

واجهة برمجة التطبيقات لتنفيذ طلبات البحث في Ads Data Hub.

الخدمة: adsdatahub.googleapis.com

لاستدعاء هذه الخدمة، ننصحك باستخدام مكتبات العملاء التي توفّرها Google. إذا كان تطبيقك بحاجة إلى استخدام مكتباتك الخاصة لطلب هذه الخدمة، استخدِم المعلومات التالية عند تقديم طلبات البيانات من واجهة برمجة التطبيقات.

مستند "اقتراحات"

مستند أثناء التصفّح هو مواصفات يمكن للجهاز قراءتها لوصف واجهات REST API واستخدامها. ويتم استخدامه لإنشاء مكتبات العملاء والمكوّنات الإضافية IDE وغيرها من الأدوات التي تتفاعل مع Google APIs. يمكن أن تقدّم خدمة واحدة مستندات استكشاف متعددة. تقدّم هذه الخدمة مستند الاكتشاف التالي:

نقطة نهاية الخدمة

نقطة نهاية الخدمة هي عنوان URL أساسي يحدِّد عنوان الشبكة لخدمة واجهة برمجة تطبيقات. قد تحتوي إحدى الخدمات على نقاط نهاية متعددة للخدمة. تتضمن هذه الخدمة نقطة نهاية الخدمة التالية وجميع معرفات الموارد المنتظمة (URI) أدناه مرتبطة بنقطة نهاية الخدمة هذه:

  • https://adsdatahub.googleapis.com

مورد REST: v1.customers

الطُرق
describeValidDv360AdvertiserIds POST /v1/{customer=customers/*}:describeValidDv360AdvertiserIds
وصف أرقام تعريف المعلِنين الصالحة في "مساحة العرض والفيديو 360"
describeValidFrequencyLimitingEventMatchers GET /v1/{customer=customers/*}:describeValidFrequencyLimitingEventMatchers
يتم إدراج مُطابقات أحداث صالحة مع بياناتها الوصفية لقوائم المستخدمين التي تحدّد عدد مرات الظهور.
exportJobHistory POST /v1/{customer=customers/*}:exportJobHistory
يتم تصدير سجلّ الوظائف لحساب عميل إلى مجموعة بيانات BigQuery التي اختارها العميل.
generateDv360IvtVideoViewabilityReport POST /v1/{customer=customers/*}:generateDv360IvtVideoViewabilityReport
تبدأ عملية تنفيذ طلب بحث لاسترداد مقاييس إمكانية عرض الزيارات غير الصالحة للنظام الأساسي "مساحة العرض والفيديو 360".
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.analysisQuries

الطُرق
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
أضِف معلِنًا في "مساحة العرض والفيديو 360" إلى المعلِنين الذين يستخدمون خوارزمية عروض الأسعار المخصّصة.
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
يُرجى إزالة مُعلِن على "مساحة العرض والفيديو 360" من المعلِنين الذين يستخدمون خوارزمية عروض الأسعار المخصّصة.

مورد 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.userListQuries

الطُرق
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
أنشِئ اشتراكات من قائمة المستخدمين.
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 يومًا.