Curation Partners API

‫Curation partners API هي واجهة برمجة تطبيقات HTTP متاحة خارجيًا للمنظِّمين لإدارة شرائح الجمهور والحِزم المنظَّمة التي تستخدمها الوكالات الإعلانية بشكل آلي.

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

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

مستند الاستكشاف

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

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

نقطة نهاية الخدمة هي الجزء الأساسي من عنوان URL الذي يحدّد عنوان الشبكة لخدمة واجهة برمجة التطبيقات. قد يكون للخدمة الواحدة أكثر من نقطة نهاية واحدة. تحتوي هذه الخدمة على نقطة النهاية التالية، وجميع عناوين URI أدناه تكون نسبيّة لهذه النقطة:

  • https://curationpartners.googleapis.com

مورد REST: ‏ v1.curators.curatedPackages

الطُرق
activate POST /v1/{name=curators/*/curatedPackages/*}:activate
تفعيل حزمة منظَّمة حالية
create POST /v1/{parent=curators/*}/curatedPackages
إنشاء حزمة منظَّمة جديدة
deactivate POST /v1/{name=curators/*/curatedPackages/*}:deactivate
إيقاف حزمة منظَّمة حالية
get GET /v1/{name=curators/*/curatedPackages/*}
الحصول على حزمة منظَّمة حسب اسم المورد
list GET /v1/{parent=curators/*}/curatedPackages
عرض الحِزم المنظَّمة التي يملكها المنظِّم المحدّد
patch PATCH /v1/{curatedPackage.name=curators/*/curatedPackages/*}
تعديل حزمة منظَّمة حالية

مورد REST: ‏ v1.curators.dataSegments

الطُرق
activate POST /v1/{name=curators/*/dataSegments/*}:activate
تفعيل شريحة بيانات
create POST /v1/{parent=curators/*}/dataSegments
إنشاء شريحة جمهور مستندة إلى البيانات يملكها المنظِّم المدرَج
deactivate POST /v1/{name=curators/*/dataSegments/*}:deactivate
إيقاف شريحة جمهور مستندة إلى البيانات
get GET /v1/{name=curators/*/dataSegments/*}
الحصول على شريحة جمهور مستندة إلى البيانات حسب اسمها
list GET /v1/{parent=curators/*}/dataSegments
عرض شرائح الجمهور المستندة إلى البيانات التي يملكها المنظِّم
patch PATCH /v1/{dataSegment.name=curators/*/dataSegments/*}
تعديل شريحة جمهور مستندة إلى البيانات

مورد REST: ‏ v1.curators.reports

الطُرق
create POST /v1/{parent=curators/*}/reports
إنشاء كائن Report
delete DELETE /v1/{name=curators/*/reports/*}
حذف كائن Report
get GET /v1/{name=curators/*/reports/*}
استرداد كائن Report
list GET /v1/{parent=curators/*}/reports
عرض كائنات Report
patch PATCH /v1/{report.name=curators/*/reports/*}
تعديل كائن Report
run POST /v1/{name=curators/*/reports/*}:run
بدء تنفيذ تقرير حالي بشكل غير متزامن

مورد REST: ‏ v1.curators.reports.operations

الطُرق
get GET /v1/{name=curators/*/reports/*/operations/*}
تتيح هذه الطريقة الاطّلاع على أحدث حالة لعملية طويلة.

مورد REST: ‏ v1.curators.reports.results

الطُرق
fetchRows GET /v1/{name=curators/*/reports/*/results/*}:fetchRows
عرض صفوف النتائج من تقرير مكتمل

مورد REST: ‏ v1.mediaPlanners

الطُرق
list GET /v1/mediaPlanners
عرض جميع حسابات مخطّط الوسائط التي يمكن للمتصل الوصول إليها