Agencies and Brands API

API آژانس‌ها و برندها یک HTTP API خارجی است که برای آژانس‌های تبلیغاتی و برندها در دسترس است تا معاملات و هزینه‌های خود را با ناشران Google Ad Manager به صورت برنامه‌نویسی مدیریت کنند.

سرویس: agencyandbrands.googleapis.com

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

سند کشف

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

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

یک نقطه پایانی سرویس ، یک URL پایه است که آدرس شبکه یک سرویس API را مشخص می‌کند. یک سرویس ممکن است چندین نقطه پایانی سرویس داشته باشد. این سرویس دارای نقطه پایانی سرویس زیر است و تمام URI های زیر مربوط به این نقطه پایانی سرویس هستند:

  • https://agenciesandbrands.googleapis.com

منبع REST: v1.agencies.reports

روش‌ها
create POST /v1/{parent=agencies/*}/reports
یک شیء Report ) ایجاد می‌کند.
delete DELETE /v1/{name=agencies/*/reports/*}
یک شیء Report را حذف می‌کند.
get GET /v1/{name=agencies/*/reports/*}
یک شیء Report را بازیابی می‌کند.
list GET /v1/{parent=agencies/*}/reports
لیست‌ها، Report اشیاء.
patch PATCH /v1/{report.name=agencies/*/reports/*}
یک شیء Report را به‌روزرسانی می‌کند.
run POST /v1/{name=agencies/*/reports/*}:run
اجرای یک گزارش موجود را به صورت غیرهمزمان آغاز می‌کند.

منبع REST: v1.agencies.reports.operations

روش‌ها
get GET /v1/{name=agencies/*/reports/*/operations/*}
آخرین وضعیت یک عملیات طولانی مدت را دریافت می‌کند.

منبع REST: v1.agencies.reports.results

روش‌ها
fetchRows GET /v1/{name=agencies/*/reports/*/results/*}:fetchRows
ردیف‌های نتیجه را از یک گزارش تکمیل‌شده برمی‌گرداند.