Method: accounts.mediationGroups.list

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

درخواست HTTP

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

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

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

پارامترها
parent

string

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

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

پارامترها
pageSize

integer

حداکثر تعداد گروه‌های میانجیگری که باید بازگردانده شوند. اگر مشخص نشود یا 0 باشد، حداکثر 10،000 گروه میانجیگری بازگردانده خواهد شد. حداکثر مقدار 20،000 است؛ مقادیر بالاتر از 20،000 به 20،000 کاهش می‌یابد.

pageToken

string

مقداری که توسط آخرین ListMediationGroupsResponse برگردانده می‌شود، نشان می‌دهد که این ادامه‌ی فراخوانی mediationGroups.list قبلی است و سیستم باید صفحه‌ی بعدی داده‌ها را برگرداند.

filter

string

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

  • "شناسه‌های منبع تبلیغات"
  • "شناسه‌های واحد تبلیغات"
  • "شناسه‌های برنامه"
  • "نام_نمایشگر"
  • "فرمت"
  • "شناسه_گروه_میانجیگری"
  • «پلتفرم»
  • "ایالت"
  • "کدهای_منطقه_هدفمند"

توابع فیلتر ممکن عبارتند از:

  • IN : برای فیلتر کردن فیلدهایی که نشان‌دهنده یک سینگلتون هستند، شامل "MEDIATION_GROUP_ID"، "DISPLAY_NAME"، "STATE"، "PLATFORM" و "FORMAT" استفاده می‌شود.
  • CONTAINS_ANY : برای فیلتر کردن فیلدهایی که مجموعه‌ای از جمله "AD_SOURCE_IDS"، "AD_UNIT_IDS"، "APP_IDS" و "TARGETED_REGION_CODES" را نشان می‌دهند، استفاده می‌شود.

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

مثال:

فیلتر: IN(DISPLAY_NAME, "گروه آزمایشی ۱", "گروه آزمایشی ۲") و IN(PLATFORM, "ANDROID") و CONTAINS_ANY(AD_SOURCE_IDS, "5450213213286189855")

درخواست بدنه

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

بدنه پاسخ

پاسخ به درخواست فهرست گروه‌های میانجیگری.

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

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

object ( MediationGroup )

گروه‌های میانجی حاصل برای حساب درخواستی.

nextPageToken

string

اگر خالی نباشد، نشان می‌دهد که ممکن است گروه‌های میانجی بیشتری برای درخواست وجود داشته باشد؛ این مقدار باید در یک ListMediationGroupsRequest جدید ارسال شود.

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

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

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

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