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 مجموعة توسّط كحدّ أقصى. الحد الأقصى للقيمة هو 20000؛ سيتم فرض القيم الأكبر من 20000 على 20000.
pageToken

string

القيمة التي تعرضها آخر ListMediationGroupsResponse؛ إلى أنّ هذه الإضافة هي استمرار لاستدعاء mediationGroups.list سابق، وأنّ النظام من المفترض أن يعرض الصفحة التالية من البيانات.
filter

string

سلسلة الفلتر التي تستخدِم بنية EBNF النحوية الحقول التي يمكن الفلترة حسبها هي:

  • "AD_SOURCE_IDS"
  • "AD_UNIT_IDS"
  • "APP_IDS"
  • "DISPLAY_NAME"
  • "التنسيق"
  • "MEDIATION_GROUP_ID"
  • "PLATFORM"
  • "الولاية"
  • "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, "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.