Curation Partners API

میانای برنامه‌سازی کاربردی شرکای گردآوری محتوا یک میانای برنامه‌سازی کاربردی HTTP است که به‌صورت خارجی دردسترس است و گردآورندگان محتوا می‌توانند از آن برای مدیریت برنامه‌ریزی‌شده بخش‌های داده و بسته‌های گردآوری‌شده خود که توسط آژانس‌های تبلیغاتی استفاده می‌شود استفاده کنند.

سرویس: curationpartners.googleapis.com

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

سند اکتشاف

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

نقطه پایان سرویس

نقطه پایان سرویس نشانی وب پایه‌ای است که نشانی شبکه سرویس میانای برنامه‌سازی کاربردی را مشخص می‌کند. یک سرویس ممکن است چندین نقطه پایانی سرویس داشته باشد. این سرویس دارای نقطه پایانی سرویس زیر است و همه شناسه منابع یکسان زیر مربوط به این نقطه پایانی سرویس هستند:

  • 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 Resource: 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 داده‌شده مطابقت دارند جستجو می‌کند.