Curation Partners API

رابط برنامه‌نویسی کاربردی شرکای گزینش (Curation partners API) یک رابط برنامه‌نویسی کاربردی HTTP خارجی است که برای گزینشگران (Curators) در دسترس است تا بخش‌های داده و بسته‌های گزینش‌شده‌ی مورد استفاده‌ی آژانس‌های تبلیغاتی را به صورت برنامه‌نویسی مدیریت کنند.

سرویس: curationpartners.googleapis.com

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

سند کشف

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

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

یک نقطه پایانی سرویس ، یک URL پایه است که آدرس شبکه یک سرویس API را مشخص می‌کند. یک سرویس ممکن است چندین نقطه پایانی سرویس داشته باشد. این سرویس دارای نقطه پایانی سرویس زیر است و تمام 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
تمام حساب‌های برنامه‌ریز رسانه‌ای که تماس‌گیرنده به آنها دسترسی دارد را فهرست می‌کند.