Method: advertisers.audit

تدقيق حساب المعلِن تعرِض هذه السمة أعداد الكيانات المستخدَمة لكل نوع من أنواع الموارد ضمن المعلِن المقدَّم. يتم احتساب الكيانات المستخدَمة ضمن حدّ الموارد المخصّص لها. يُرجى الاطّلاع على https://support.google.com/displayvideo/answer/6071450.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
advertiserId

string (int64 format)

مطلوب. رقم تعريف المعلِن المطلوب تدقيقه.

مَعلمات طلب البحث

المعلمات
readMask

string (FieldMask format)

اختياريّ. الحقول المحدّدة المطلوب عرضها. في حال عدم تحديد قناع، سيتم ملء جميع الحقول في ملف proto الخاص بالاستجابة. القيم الصالحة هي:

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

هذه قائمة مفصولة بفواصل تتضمّن أسماء حقول مؤهَّلة بالكامل. مثال: "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)

عدد العناصر "نشطة" و"متوقفة مؤقتًا" و"مسودة" ضمن هذا المعلِن تُحتسب هذه العناصر ضمن الحد الأقصى المسموح به وهو 9999 عنصرًا لكل معلن.
usedInsertionOrdersCount

string (int64 format)

عدد طلبات الإدراج النشطة والمتوقفة مؤقتًا والمسودة ضمن هذا المعلن. يتم احتساب طلبات الإدراج هذه ضمن الحدّ الأقصى المسموح به وهو 9999 طلب إدراج لكلّ معلِن.
usedCampaignsCount

string (int64 format)

عدد الحملات النشطة والمتوقفة مؤقتًا ضمن هذا المعلِن ويتم احتساب هذه الحملات ضمن الحدّ الأقصى المسموح به وهو 9999 حملة لكل معلِن.
channelsCount

string (int64 format)

عدد القنوات التي تم إنشاؤها ضمن هذا المعلِن ويتم احتساب هذه القنوات ضمن الحد الأقصى المسموح به وهو 1,000 قناة لكل معلِن.
negativelyTargetedChannelsCount

string (int64 format)

عدد القنوات المستهدَفة سلبًا التي تم إنشاؤها ضمن هذا المعلِن. ويتم احتساب هذه القنوات المستهدفة سلبًا ضمن الحد الأقصى وهو 5 قنوات مستهدفة سلبيًا لكل معلن.
negativeKeywordListsCount

string (int64 format)

عدد قوائم الكلمات الرئيسية السلبية التي تم إنشاؤها ضمن هذا المُعلِن. وتُحتسَب قوائم الكلمات الرئيسية السلبية هذه ضمن الحدّ الأقصى المسموح به وهو 20 قائمة كلمات رئيسية سلبية لكلّ مُعلِن.
adGroupCriteriaCount

string (int64 format)

عدد خيارات الاستهداف الفردية من أنواع الاستهداف التالية التي تم تحديدها لعنصر ضمن هذا المعلِن. تُحتسَب خيارات الاستهداف الفردية هذه ضمن الحدّ الأقصى البالغ 4500000 خيار استهداف للمجموعة الإعلانية لكلّ معلِن.

أنواع الاستهداف المؤهَّلة:

  • القنوات وعناوين URL والتطبيقات والمجموعات
  • الخصائص الديموغرافية
  • شرائح جمهور Google، بما في ذلك شرائح الجمهور ذات الاهتمامات المشتركة والجماهير المخصّصة ذات الاهتمامات المشتركة وشرائح الجمهور في السوق
  • مصدر المخزون
  • الكلمة الرئيسية
  • فئة تطبيق متوافق مع الأجهزة الجوّالة
  • قوائم المستخدمين
  • استهداف الفيديو
  • إمكانية العرض
campaignCriteriaCount

string (int64 format)

عدد خيارات الاستهداف الفردية من أنواع الاستهداف التالية التي تمّ تعيينها لبند ضمن هذا المعلِن تُحتسَب خيارات الاستهداف الفردية هذه ضمن الحدّ الأقصى البالغ 900,000 خيار استهداف للحملة لكلّ معلِن.

أنواع الاستهداف المؤهَّلة:

  • الموضع
  • المتصفح
  • سرعة الاتصال
  • اليوم والوقت
  • الجهاز ونظام التشغيل
  • تصنيف المحتوى الرقمي
  • الفئات الإعلانية الحساسة
  • البيئة
  • الموقع الجغرافي، بما في ذلك سلاسل الأنشطة التجارية والقرب
  • معالج إشارة الصور (ISP)
  • Language
  • إثبات الملكية من خلال جهة خارجية

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.