Method: accounts.mediationGroups.list

تعرض هذه الطريقة مجموعات التوسّط ضمن حساب AdMob المحدّد.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز إلى 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 في ما يلي الحقول المحتملة التي يمكن الفلترة حسبها:

  • "AD_SOURCE_IDS"
  • "AD_UNIT_IDS"
  • "APP_IDS"
  • "DISPLAY_NAME"
  • "FORMAT"
  • "MEDIATION_GROUP_ID"
  • "PLATFORM"
  • "STATE"
  • "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.

مثال:

filter: IN(DISPLAY_NAME, "Test Group 1", "Test Group 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 Overview.