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 Overview.