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"

نص الطلب

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

نص الاستجابة

رسالة ردّ على المُعلِنService.التدقيقالمُعلِن

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

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

string (int64 format)

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

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)

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

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

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

string (int64 format)

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

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

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

نطاقات الأذونات

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

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

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