Method: accounts.mediationGroups.list

הצגת רשימה של קבוצות לבחירת רשת (Mediation) בחשבון 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"
  • 'מצב'
  • 'TARGETED_REGION_CODES'

פונקציות הסינון האפשריות הן:

  • IN: משמש לסינון שדות שמייצגים טון יחיד, כולל 'MEDIATION_GROUP_ID', 'DISPLAY_NAME', 'מצב', '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.