Method: accounts.adUnits.adUnitMappings.list

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

درخواست HTTP

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

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

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

پارامترها
parent

string

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

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

پارامترها
pageSize

integer

حداکثر تعداد نگاشت واحد تبلیغات برای بازگشت. اگر نامشخص یا 0 باشد، حداکثر 10000 نگاشت واحد تبلیغاتی برگردانده می شود. حداکثر مقدار 20000 است. مقادیر بالای 20000 به 20000 اجباری می شود.

pageToken

string

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

filter

string

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

  • "DISPLAY_NAME"

عملکرد فیلتر ممکن است:

  • IN : برای فیلتر کردن فیلدهایی استفاده می‌شود که نشان‌دهنده یک صدا از جمله «DISPLAY_NAME» هستند.

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

مثال:

فیلتر: IN(DISPLAY_NAME، «نقشه برداری واحد آگهی آزمایشی 1»، «نقشه برداری واحد آگهی آزمایشی 2»)

درخواست بدن

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

بدن پاسخگو

پاسخ برای 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 مراجعه کنید.