Method: accounts.mediationGroups.list

מציג את הקבוצות לבחירת רשת בחשבון AdMob שצוין.

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
parent

string

חובה. שם המשאב של החשבון שרוצים להציג את הקבוצות לבחירת רשת שלו. לדוגמה: accounts/pub-9876543210987654

פרמטרים של שאילתה

פרמטרים
pageSize

integer

מספר קבוצות הגישור המקסימלי שיוחזרו. אם לא מציינים ערך או מציינים 0, יוחזרו לכל היותר 10,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: משמש לסינון שדות שמייצגים singleton, כולל 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")

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

תשובה לבקשה של רשימת הקבוצות לבחירת רשת (Mediation).

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג ב-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.