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 وحدة إعلانية كحدّ أقصى. الحد الأقصى للقيمة هو 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.readonly

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

AdUnit

تصف وحدة إعلانية في AdMob.

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

string

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

string

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

string

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

string

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

string

شكل الإعلان للوحدة الإعلانية. في ما يلي القيم المحتمَلة:

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

string

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

RICH_MEDIA (RICH_MEDIA) - الوسائط النصية والصورية وغيرها من الوسائط غير المرئية "فيديو" - وسائط الفيديو.