Method: accounts.adUnits.adUnitMappings.list

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

בקשת HTTP

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

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

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

פרמטרים
parent

string

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

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

פרמטרים
pageSize

integer

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

string

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

string

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

  • "DISPLAY_NAME"

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

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

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

דוגמה:

filter: IN(DISPLAY_NAME, "Test Ad Unit Mapping 1", "Test Ad Unit Mapping 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 Overview.