Method: advertisers.audit

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

طلب HTTP

GET https://displayvideo.googleapis.com/v5/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.AuditAdvertiser.

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

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

عدد طلبات الإدراج النشطة والمتوقفة مؤقتًا والمسودات التابعة لهذا المعلِن ويتم احتساب طلبات الإدراج هذه ضمن الحدّ الأقصى البالغ 9,999 طلب إدراج لكل معلِن.
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)

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

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

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

string (int64 format)

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

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

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

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

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

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

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