واجهة Curation partners API هي واجهة HTTP متاحة خارجيًا لمنسّقي الإعلانات من أجل إدارة شرائح البيانات والحِزم المنسّقة التي تستخدمها الوكالات الإعلانية آليًا.
- مورد REST: v1.curators.curatedPackages
- مورد REST: v1.curators.dataSegments
- مورد REST: v1.curators.reports
- مورد REST: v1.curators.reports.operations
- مورد REST: v1.curators.reports.results
- مورد REST: v1.mediaPlanners
الخدمة: 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 المحدّد. |