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 عملية ربط للوحدات الإعلانية على الأكثر. الحد الأقصى للقيمة هو 20000؛ سيتم فرض القيم الأكبر من 20000 على 20000.
pageToken

string

رمز مميّز للصفحة، تم تلقّيه من استدعاء سابق لتطبيق "adUnitMappings.list". يمكنك توفير هذا الحقل لاسترداد الصفحة التالية.
filter

string

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

  • "DISPLAY_NAME"

دالة التصفية المحتملة هي:

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

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

مثال:

الفلتر: IN(DISPLAY_NAME, "اختبار ربط الوحدة الإعلانية 1", "اختبار ربط الوحدة الإعلانية 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.