Method: advertisers.audit

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

طلب HTTP

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

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

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

المَعلمات
advertiserId

string (int64 format)

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

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

المَعلمات
readMask

string (FieldMask format)

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

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

هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "user.displayName,photo"

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

رسالة رد لـAdvertisingService.AdMobAdvertiser.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "usedLineItemsCount": string,
  "usedInsertionOrdersCount": string,
  "usedCampaignsCount": string,
  "channelsCount": string,
  "negativelyTargetedChannelsCount": string,
  "negativeKeywordListsCount": string,
  "adGroupCriteriaCount": string,
  "campaignCriteriaCount": string
}
الحقول
usedLineItemsCount

string (int64 format)

عدد العناصر النشطة والمتوقفة مؤقتًا والمسودة ضمن هذا المعلن. ويتمّ احتساب هذه العناصر ضمن الحدّ الأقصى الذي يبلغ 9,999 عنصرًا لكلّ مُعلِن.
usedInsertionOrdersCount

string (int64 format)

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

string (int64 format)

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

string (int64 format)

عدد القنوات التي تم إنشاؤها تحت إشراف هذا المعلن. تُحتسب هذه القنوات ضمن الحدّ الأقصى المسموح به، وهو 1000 قناة لكل معلن.
negativelyTargetedChannelsCount

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

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

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

string (int64 format)

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

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

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

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

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

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

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