Method: accounts.adUnits.adUnitMappings.list

تعرض هذه السمة عمليات ربط الوحدات الإعلانية ضِمن حساب AdMob والوحدة الإعلانية المحدّدين.

طلب HTTP

GET https://admob.googleapis.com/v1beta/{parent=accounts/*/adUnits/*}/adUnitMappings

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

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

المعلمات
parent

string

الحقل مطلوب. العنصر الرئيسي الذي يملك هذه المجموعة من عمليات ربط الوحدات الإعلانية. التنسيق: accounts/{publisherId}/adUnits/{adUnitId}

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

المعلمات
pageSize

integer

الحدّ الأقصى لعدد عمليات ربط الوحدات الإعلانية التي سيتم عرضها. إذا لم يتم تحديدها أو كانت القيمة 0، سيتم عرض 10,000 عملية ربط وحدات إعلانية كحدّ أقصى. الحد الأقصى للقيمة هو 20,000، وسيتم فرض القيمة 20,000 على القيم التي تزيد عن 20,000.
pageToken

string

رمز مميز للصفحة تم تلقّيه من طلب adUnitMappings.list سابق. يجب تقديم هذا الرمز لاسترداد الصفحة التالية.
filter

string

سلسلة الفلتر التي تستخدم بنية قواعد EBNF الحقل الذي يمكن إجراء الفلترة حسبه هو:

  • "DISPLAY_NAME"

يمكن أن تكون دالة الفلتر كما يلي:

  • ‫IN: تُستخدَم لفلترة الحقول التي تمثّل عنصرًا واحدًا، بما في ذلك "DISPLAY_NAME".

يمكن إضافة دوال الفلتر معًا باستخدام AND. لا تتوفّر وظيفة OR.

مثال:

filter: IN(DISPLAY_NAME, "Test Ad Unit Mapping 1", "Test Ad Unit Mapping 2")

نص الطلب

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

نص الاستجابة

الردّ على ListAdUnitMappingsRequest.

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

تمثيل JSON 
{
  "adUnitMappings": [
    {
      object (AdUnitMapping)
    }
  ],
  "nextPageToken": string
}
الحقول
adUnitMappings[]

object (AdUnitMapping)

عمليات ربط الوحدات الإعلانية من الحساب والوحدة الإعلانية المحدّدين
nextPageToken

string

يُستخدَم لضبط pageToken في ListAdUnitMappingsRequest من أجل استرداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

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

يجب توفير أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/admob.monetization
  • https://www.googleapis.com/auth/admob.readonly

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