Method: advertisers.audit

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

درخواست HTTP

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

نشانی وب از نحو تراتبدیل gRPC استفاده می‌کند.

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

پارامترها
advertiserId

string (int64 format)

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

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

پارامترها
readMask

string (FieldMask format)

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

  • usedLineItemsCount
  • usedInsertionOrdersCount
  • usedCampaignsCount
  • channelsCount
  • negativelyTargetedChannelsCount
  • negativeKeywordListsCount
  • adGroupCriteriaCount
  • campaignCriteriaCount

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

متن درخواست

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

بدنه پاسخ

Response message for AdvertiserService.AuditAdvertiser.

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

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

string (int64 format)

تعداد موارد خطی «فعال»، «موقت متوقف‌شده»، و «پیش‌نویس» در این تبلیغ‌کننده. این موارد سطری جزو محدودیت ۹۹۹۹ مورد سطری برای هر آگهی‌دهنده محسوب می‌شوند.
usedInsertionOrdersCount

string (int64 format)

تعداد سفارش‌های درج «فعال»، «متوقف‌شده»، و «پیش‌نویس» تحت این تبلیغ‌کننده. این سفارش‌های درج در حد مجاز ۹۹۹۹ سفارش درج برای هر تبلیغ‌کننده لحاظ می‌شوند.
usedCampaignsCount

string (int64 format)

تعداد پویش‌های «فعال» و «موقتاً متوقف‌شده» تحت این تبلیغ‌کننده. این پویش‌ها در محدودیت ۹۹۹۹ پویش برای هر تبلیغ‌کننده لحاظ می‌شوند.
channelsCount

string (int64 format)

تعداد کانال‌های ایجادشده تحت این تبلیغ‌کننده. این کانال‌ها در حد مجاز ۱۰۰۰ کانال برای هر تبلیغ‌کننده لحاظ می‌شوند.
negativelyTargetedChannelsCount

string (int64 format)

تعداد کانال‌های هدف‌یابی‌شده منفی که تحت این تبلیغ‌کننده ایجاد شده است. این کانال‌های هدف‌یابی‌شده منفی در حد ۵ کانال هدف‌یابی‌شده منفی برای هر تبلیغ‌کننده به‌حساب می‌آیند.
negativeKeywordListsCount

string (int64 format)

تعداد فهرست‌های کلیدواژه‌های منفی ایجادشده تحت این تبلیغ‌کننده. این فهرست‌های کلیدواژه‌های منفی در محدودیت ۲۰ فهرست کلیدواژه‌های منفی برای هر تبلیغ‌کننده لحاظ می‌شوند.
adGroupCriteriaCount

string (int64 format)

تعداد گزینه‌های هدف‌یابی تکی از انواع هدف‌یابی زیر که به یک مورد خطی تحت این آگهی‌دهنده اختصاص داده شده‌اند. این گزینه‌های هدف‌یابی فردی در محدودیت ۴٬۵۰۰٬۰۰۰ گزینه هدف‌یابی گروه آگهی برای هر تبلیغ‌کننده لحاظ می‌شوند.

انواع هدف‌یابی واجدشرایط:

  • کانال‌ها، نشانی‌های وب، برنامه‌ها، و مجموعه‌ها
  • آمارهای جمعیتی
  • مخاطبان Google، ازجمله مخاطبان همگرا، همگرای سفارشی، و جویای خرید
  • منبع فضای آگهی
  • کلیدواژه
  • دسته برنامه تلفن همراه
  • فهرست‌های کاربر
  • انتخاب هدف ویدیو
  • قابلیت مشاهده
campaignCriteriaCount

string (int64 format)

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

انواع هدف‌یابی واجدشرایط:

  • موقعیت
  • مرورگر
  • سرعت اتصال
  • روز و ساعت
  • دستگاه و سیستم‌عامل
  • برچسب محتوای دیجیتال
  • دسته‌های حساس
  • محیط زیست
  • جغرافیا، ازجمله کسب‌وکارهای زنجیره‌ای و مجاورت
  • پردازشگر سیگنال تصویر : ISP
  • زبان
  • درستی‌سنجی طرف سوم

دامنه‌های مجوز

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

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

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