Method: advertisers.audit

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

طلب HTTP

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

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

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

المَعلمات
advertiserId

string (int64 format)

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

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

المَعلمات
readMask

string (FieldMask format)

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

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

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

نص الطلب

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

نص الاستجابة

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

رسالة رد لـ AdvertiserService.طةلل يؤدي إلى معلن.

تمثيل 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)

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

string (int64 format)

عدد القنوات التي تم إنشاؤها تحت إشراف هذا المعلن. ويتم احتساب هذه القنوات ضمن الحدّ الأقصى المسموح به لكل معلن، وهو 1,000 قناة.
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.