Method: accounts.adUnits.list

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

בקשת HTTP

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

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

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

פרמטרים
parent

string

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

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

פרמטרים
pageSize

integer

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

pageToken

string

הערך שהוחזר על ידי ListAdUnitsResponse האחרון; מציין כי זהו המשך של קריאה קודמת ל-adUnits.list, ושהמערכת צריכה להחזיר את דף הנתונים הבא.

גוף הבקשה

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

גוף התגובה

תגובה לבקשה של רשימת יחידות המודעות.

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

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

object (AdUnit)

יחידות המודעות שהתקבלו בחשבון המבוקש.

nextPageToken

string

אם השדה לא ריק, המשמעות היא שייתכן שיש יותר יחידות מודעות עבור הבקשה. יש להעביר את הערך הזה ב-ListAdUnitsRequest חדש.

היקפי הרשאות

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

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

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