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.