Method: accounts.adUnits.list

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

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

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

پارامترها
parent

string

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

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

پارامترها
pageSize

integer

حداکثر تعداد واحدهای تبلیغاتی برای بازگشت. اگر نامشخص یا 0 باشد، حداکثر 10000 واحد تبلیغاتی برگردانده می شود. حداکثر مقدار 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 مراجعه کنید.