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.

مثال:

الفلتر: 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.