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
تعرض هذه الطريقة جميع حسابات "منسق وسائط الإعلان" التي يمكن للمتصل الوصول إليها.
search GET /v1/mediaPlanners:search
يبحث عن حسابات منسق وسائط الإعلان التي تتطابق مع رقم تعريف حساب DSP المحدّد.