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)

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

  • 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)

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