Method: accounts.mediationGroups.list

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

درخواست HTTP

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

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

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

پارامترها
parent

string

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

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

پارامترها
pageSize

integer

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

pageToken

string

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

filter

string

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

  • "AD_SOURCE_IDS"
  • "AD_UNIT_IDS"
  • "APP_IDS"
  • "DISPLAY_NAME"
  • "FORMAT"
  • "MEDIATION_GROUP_ID"
  • "پلتفرم"
  • "دولت"
  • "TARGETED_REGION_CODES"

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

  • 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، "گروه آزمایشی 1"، "گروه آزمایشی 2") AND IN(PLATFORM، "ANDROID") AND 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 مراجعه کنید.