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