Method: accounts.adUnits.adUnitMappings.list

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

درخواست HTTP

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

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

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

پارامترها
parent

string

الزامی. والدی که مالک این مجموعه از نگاشت‌های واحد تبلیغاتی است. قالب: accounts/{publisherId}/adUnits/{adUnitId}

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

پارامترها
pageSize

integer

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

pageToken

string

یک توکن صفحه، که از فراخوانی قبلی adUnitMappings.list دریافت شده است. این توکن را برای بازیابی صفحه بعدی ارائه دهید.

filter

string

رشته فیلتری که از نحو دستوری EBNF استفاده می‌کند. فیلد ممکن برای فیلتر کردن بر اساس:

  • "نام_نمایشگر"

عملکرد فیلتر احتمالی:

  • IN : برای فیلتر کردن فیلدهایی که نشان‌دهنده یک سینگلتون شامل "DISPLAY_NAME" هستند، استفاده می‌شود.

توابع فیلتر را می‌توان با استفاده از AND با هم جمع کرد. قابلیت OR پشتیبانی نمی‌شود.

مثال:

فیلتر: IN(DISPLAY_NAME, "نگاشت واحد تبلیغ آزمایشی ۱", "نگاشت واحد تبلیغ آزمایشی ۲")

درخواست بدنه

بدنه درخواست باید خالی باشد.

بدنه پاسخ

پاسخ برای ListAdUnitMappingsRequest.

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "adUnitMappings": [
    {
      object (AdUnitMapping)
    }
  ],
  "nextPageToken": string
}
فیلدها
adUnitMappings[]

object ( AdUnitMapping )

نگاشت‌های واحد تبلیغاتی از حساب و واحد تبلیغاتی مشخص‌شده.

nextPageToken

string

برای تنظیم pageToken در ListAdUnitMappingsRequest جهت بازیابی صفحه بعدی استفاده می‌شود. اگر این فیلد حذف شود، صفحات بعدی وجود نخواهند داشت.

دامنه‌های مجوز

به یکی از حوزه‌های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/admob.monetization
  • https://www.googleapis.com/auth/admob.readonly

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .