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 קבוצות לבחירת רשת (Mediation). הערך המקסימלי הוא 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 אינה נתמכת.

דוגמה:

מסנן: 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.