Method: advertisers.audit

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

درخواست HTTP

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

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

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

پارامترها
advertiser Id

string ( int64 format)

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

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

پارامترها
read Mask

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
}
فیلدها
used Line Items Count

string ( int64 format)

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

used Insertion Orders Count

string ( int64 format)

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

used Campaigns Count

string ( int64 format)

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

channels Count

string ( int64 format)

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

negatively Targeted Channels Count

string ( int64 format)

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

negative Keyword Lists Count

string ( int64 format)

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

ad Group Criteria Count

string ( int64 format)

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

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

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

string ( int64 format)

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

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

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

محدوده مجوز

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

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

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