Method: accounts.adUnits.adUnitMappings.list

צריך להציג רשימה של מיפויים של יחידות מודעות בחשבון AdMob וביחידת המודעות שצוינו.

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

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

פרמטרים
parent

string

חובה. ההורה שהוא הבעלים של אוסף המיפויים של יחידות המודעות. פורמט: accounts/{publisherId}/adUnits/{adUnitId}

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

פרמטרים
pageSize

integer

המספר המקסימלי של מיפויים של יחידות מודעות שיש להחזיר. אם לא צוין 0 או אם לא, יוחזרו עד 10,000 מיפויים של יחידות מודעות. הערך המקסימלי הוא 20,000. ערכים מעל 20,000 ישתנו ל-20,000.
pageToken

string

אסימון דף שהתקבל משיחה קודמת ב-adUnitMappings.list. צריך לספק אותו כדי לאחזר את הדף הבא.
filter

string

מחרוזת המסנן שבה נעשה שימוש בתחביר הדקדוק של EBNF. השדה שניתן לסנן לפיו הוא:

  • 'DISPLAY_NAME'

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

  • IN: משמש לסינון שדות שמייצגים סינגלטון, כולל "DISPLAY_NAME".

אפשר לחבר את פונקציות הסינון באמצעות הפונקציה AND. הפונקציונליות OR אינה נתמכת.

דוגמה:

מסנן: IN(DISPLAY_NAME, "מיפוי יחידת מודעות בדיקה 1", "מיפוי יחידת מודעות בדיקה 2")

גוף הבקשה

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

גוף התגובה

תשובה ל-ListAdUnitMappingsRequest.

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

ייצוג JSON 
{
  "adUnitMappings": [
    {
      object (AdUnitMapping)
    }
  ],
  "nextPageToken": string
}
שדות
adUnitMappings[]

object (AdUnitMapping)

המיפויים של יחידות המודעות מהחשבון ומיחידת המודעות שצוינו.
nextPageToken

string

משמש להגדרת pageToken בListAdUnitMappingsRequest לאחזור הדף הבא. אם השדה הזה יושמט, לא יופיעו דפים נוספים.

היקפי הרשאות

כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של OAuth:

  • https://www.googleapis.com/auth/admob.monetization
  • https://www.googleapis.com/auth/admob.readonly

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.