Method: accounts.adUnits.list

تعرض هذه الطريقة الوحدات الإعلانية ضمن حساب AdMob المحدّد.

طلب HTTP

GET https://admob.googleapis.com/v1/{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.readonly

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

AdUnit

تصف هذه السمة وحدة إعلانية في AdMob.

تمثيل JSON 
{
  "name": string,
  "adUnitId": string,
  "appId": string,
  "displayName": string,
  "adFormat": string,
  "adTypes": [
    string
  ]
}
الحقول
name

string

اسم المورد لهذه الوحدة الإعلانية. التنسيق هو accounts/{publisherId}/adUnits/{ad_unit_id_fragment}‎، مثال: accounts/pub-9876543210987654/adUnits/0123456789
adUnitId

string

المعرّف المرئي خارجيًا للوحدة الإعلانية والذي يمكن استخدامه للتكامل مع حزمة تطوير البرامج (SDK) الخاصة بمنصة AdMob. هذه السمة مخصّصة للقراءة فقط. مثال: ca-app-pub-9876543210987654/0123456789
appId

string

المعرّف المرئي خارجيًا للتطبيق المرتبط بهذه الوحدة الإعلانية مثال: ca-app-pub-9876543210987654~0123456789
displayName

string

الاسم المعروض للوحدة الإعلانية كما يظهر في واجهة مستخدم AdMob، والذي يقدّمه المستخدم. الحد الأقصى للطول المسموح به هو 80 حرفًا.
adFormat

string

AdFormat الخاص بالوحدة الإعلانية. القيم المحتمَلة هي كما يلي:

‫"APP_OPEN" - شكل الإعلان عند فتح التطبيق ‫"BANNER": شكل إعلان البانر. ‫"BANNER_INTERSTITIAL" - شكل إعلان قديم يمكن استخدامه كإعلان بانر أو إعلان بيني. لم يعُد بالإمكان إنشاء هذا التنسيق، ولكن يمكن استهدافه من خلال مجموعات التوسّط. "إعلان بيني": إعلان بملء الشاشة أنواع الإعلانات المتاحة هي "RICH_MEDIA" و "VIDEO". ‫"NATIVE": شكل الإعلان المدمج مع المحتوى "إعلان مقابل مكافأة": هو إعلان يتم عرض مكافأة للمستخدم بعد مشاهدته، ويتم التحقّق من صحة المشاهدة من خلال معاودة الاتصال. أنواع الإعلانات المتوافقة هي "RICH_MEDIA" (تفاعلية) والفيديو حيث لا يمكن استبعاد الفيديو. ‫"REWARDED_INTERSTITIAL" - شكل الإعلان البيني مقابل مكافأة يتوافق فقط مع نوع إعلان الفيديو. يمكنك الاطّلاع على https://support.google.com/admob/answer/9884467.
adTypes[]

string

نوع وسائط الإعلان المتوافق مع هذه الوحدة الإعلانية القيم المحتملة هي:

‫"RICH_MEDIA" - النص والصورة والوسائط الأخرى غير الفيديو ‫"VIDEO": وسائط الفيديو