Method: accounts.adUnits.list

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

طلب HTTP

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

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

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

المَعلمات
parent

string

مطلوبة. اسم مورد الحساب المطلوب إدراج الوحدات الإعلانية له. مثال: accounts/pub-9876543210987654

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

المَعلمات
pageSize

integer

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

string

تشير القيمة التي تعرضها آخر ListAdUnitsResponse إلى أنّ هذا الطلب هو استمرار لاستدعاء adUnits.list سابق، وأنّ النظام يجب أن يعرض الصفحة التالية من البيانات.

نص الطلب

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

نص الاستجابة

الرد على طلب قائمة الوحدات الإعلانية.

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

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

object (AdUnit)

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

string

إذا لم يكن الحقل فارغًا، يشير ذلك إلى احتمال وجود المزيد من الوحدات الإعلانية للطلب، ويجب تمرير هذه القيمة في ListAdUnitsRequest جديد.

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

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

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.