Method: accounts.adUnits.list

واحدهای تبلیغاتی را در حساب AdMob مشخص شده فهرست کنید.

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
parent

string

الزامی. نام منبع حسابی که واحدهای تبلیغاتی برای آن فهرست می‌شوند. مثال: accounts/pub-9876543210987654

پارامترهای پرس و جو

پارامترها
pageSize

integer

حداکثر تعداد واحدهای تبلیغاتی که باید بازگردانده شوند. اگر مشخص نشود یا ۰ باشد، حداکثر ۱۰۰۰۰ واحد تبلیغاتی بازگردانده خواهد شد. حداکثر مقدار ۲۰۰۰۰ است؛ مقادیر بالاتر از ۲۰۰۰۰ به ۲۰۰۰۰ کاهش می‌یابد.

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 .