Method: advertisers.audit

یک تبلیغ کننده را ممیزی می کند. تعداد موجودیت های استفاده شده را در هر نوع منبع در آگهی دهنده ارائه شده برمی گرداند. موجودیت های استفاده شده در حد منابع مربوطه به حساب می آیند. به https://support.google.com/displayvideo/answer/6071450 مراجعه کنید.

درخواست HTTP

GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}:audit

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
advertiserId

string ( int64 format)

مورد نیاز. شناسه آگهی دهنده برای ممیزی.

پارامترهای پرس و جو

پارامترها
readMask

string ( FieldMask format)

اختیاری. زمینه های خاص برای بازگشت. اگر ماسک مشخص نشده باشد، تمام فیلدهای پروتو پاسخ پر می شود. مقادیر معتبر عبارتند از:

  • UseLineItemsCount
  • usedInsertionOrdersCount
  • usedCampaignsCount
  • تعداد کانال ها
  • تعداد کانال های با هدف منفی
  • negativeKeywordListsCount
  • adGroupCriteriaCount
  • شمارش معیارهای کمپین

این فهرستی از نام‌های فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" .

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

پیام پاسخ برای AdvertiserService.AuditAdvertiser.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "usedLineItemsCount": string,
  "usedInsertionOrdersCount": string,
  "usedCampaignsCount": string,
  "channelsCount": string,
  "negativelyTargetedChannelsCount": string,
  "negativeKeywordListsCount": string,
  "adGroupCriteriaCount": string,
  "campaignCriteriaCount": string
}
فیلدها
usedLineItemsCount

string ( int64 format)

تعداد موارد خط ACTIVE، PAUSED، و DRAFT در این آگهی‌دهنده. این اقلام خطی در حد 9999 مورد به ازای هر تبلیغ‌کننده حساب می‌شوند.

usedInsertionOrdersCount

string ( int64 format)

تعداد سفارش‌های درج ACTIVE، PAUSED و DRAFT تحت این آگهی‌دهنده. این سفارش‌های درج به‌ازای هر آگهی‌دهنده از 9999 سفارش درج به حساب می‌آیند.

usedCampaignsCount

string ( int64 format)

تعداد کمپین‌های ACTIVE و PAUSED تحت این آگهی‌دهنده. این کمپین‌ها در حد 9999 کمپین به ازای هر تبلیغ‌کننده حساب می‌شوند.

channelsCount

string ( int64 format)

تعداد کانال هایی که تحت این تبلیغ کننده ایجاد شده است. این کانال ها برای هر تبلیغ کننده حداکثر 1000 کانال محسوب می شوند.

negativelyTargetedChannelsCount

string ( int64 format)

تعداد کانال‌هایی که با هدف منفی ایجاد شده‌اند تحت این تبلیغ‌کننده. این کانال‌های هدف‌گذاری شده منفی در حد 5 کانال با هدف منفی برای هر تبلیغ‌کننده حساب می‌شوند.

negativeKeywordListsCount

string ( int64 format)

تعداد فهرست‌های کلیدواژه منفی ایجاد شده تحت این تبلیغ‌کننده. این فهرست‌های کلیدواژه منفی به‌ازای هر تبلیغ‌کننده، در حد 20 فهرست کلیدواژه منفی حساب می‌شوند.

adGroupCriteriaCount

string ( int64 format)

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

انواع هدف گذاری واجد شرایط:

  • کانال ها، URL ها، برنامه ها و مجموعه ها
  • جمعیت شناختی
  • مخاطبان Google، از جمله مخاطبان Affinity، Custom Affinity و In-market
  • منبع موجودی
  • کلمه کلیدی
  • دسته برنامه موبایل
  • لیست های کاربران
  • هدف گذاری ویدیو
  • قابلیت مشاهده
campaignCriteriaCount

string ( int64 format)

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

انواع هدف گذاری واجد شرایط:

  • موقعیت
  • مرورگر
  • سرعت اتصال
  • روز و ساعت
  • دستگاه و سیستم عامل
  • برچسب محتوای دیجیتال
  • دسته بندی های حساس
  • محیط زیست
  • جغرافیا، از جمله زنجیره های تجاری و مجاورت
  • ISP
  • زبان
  • تأیید شخص ثالث

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/display-video

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.