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"
  • "التنسيق"
  • "MEDIATION_GROUP_ID"
  • "المنصة"
  • "STATE"
  • رموز_منطقة_الاستهداف

وظائف الفلترة المحتمَلة هي:

  • IN: يتم استخدامه لفلترة الحقول التي تمثّل سينغلتون بما في ذلك "MEDIATION_GROUP_ID" و"DISPLAY_NAME" و"STATE" و"PLATFORM" و "FORMAT".
  • CONTAINS_ANY: يتم استخدامه لفلترة الحقول التي تمثّل مجموعة بما في ذلك "AD_SOURCE_IDS" و"AD_UNIT_IDS" و"APP_IDS" و "TARGETED_AREA_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.