Method: accounts.adUnits.list

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

בקשת HTTP

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

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

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

פרמטרים
parent

string

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

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

פרמטרים
pageSize

integer

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