Method: accounts.apps.list

רשום את האפליקציות בחשבון AdMob שצוין.

בקשת HTTP

GET https://admob.googleapis.com/v1/{parent=accounts/*}/apps

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

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

פרמטרים
parent

string

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

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

פרמטרים
pageSize

integer

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

string

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

גוף הבקשה

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

גוף התגובה

תשובה לבקשה לרשימת האפליקציות.

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

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

object (App)

האפליקציות שהתקבלו עבור החשבון המבוקש.
nextPageToken

string

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

היקפי הרשאות

נדרש היקף OAuth הבא:

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

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

אפליקציה

מתאר אפליקציה של AdMob לפלטפורמה ספציפית (לדוגמה: Android או iOS).

ייצוג JSON 
{
  "name": string,
  "appId": string,
  "platform": string,
  "manualAppInfo": {
    object (ManualAppInfo)
  },
  "linkedAppInfo": {
    object (LinkedAppInfo)
  },
  "appApprovalState": enum (AppApprovalState)
}
שדות
name

string

שם המשאב לאפליקציה הזו. הפורמט הוא accounts/{publisherId}/apps/{app_id_fragment} דוגמה: accounts/pub-9876543210987654/apps/0123456789
appId

string

המזהה הגלוי החיצוני של האפליקציה שניתן להשתמש בו בשילוב עם AdMob SDK. זהו מאפיין לקריאה בלבד. לדוגמה: ca-app-pub-9876543210987654~0123456789
platform

string

מתאר את הפלטפורמה של האפליקציה. מוגבל ל-"iOS" ול-"Android".
manualAppInfo

object (ManualAppInfo)

המידע על האפליקציה שלא מקושרת לאף חנות אפליקציות.

לאחר קישור אפליקציה, עדיין ניתן לאחזר את המידע הזה. אם לא יסופק שם לאפליקציה במהלך היצירה, ייעשה שימוש בשם שומר מקום.
linkedAppInfo

object (LinkedAppInfo)

לא משתנה. המידע על אפליקציה שמקושרת לחנות אפליקציות.

השדה הזה מופיע אם ורק אם האפליקציה מקושרת לחנות אפליקציות.
appApprovalState

enum (AppApprovalState)

פלט בלבד. מצב האישור של האפליקציה. השדה מוגדר לקריאה בלבד.

ManualAppInfo

מידע שסופק לגבי אפליקציות ידניות שלא מקושרות לחנות אפליקציות (לדוגמה: Google Play, App Store).

ייצוג JSON 
{
  "displayName": string
}
שדות
displayName

string

השם המוצג של האפליקציה כפי שמופיע בממשק המשתמש של AdMob, שהמשתמש מספק. האורך המקסימלי המותר הוא 80 תווים.

LinkedAppInfo

מידע מחנות האפליקציות, אם האפליקציה מקושרת לחנות אפליקציות.

ייצוג JSON 
{
  "appStoreId": string,
  "displayName": string
}
שדות
appStoreId

string

מזהה חנות האפליקציות של האפליקציה, יש לציין אם ורק אם האפליקציה מקושרת לחנות אפליקציות.

אם האפליקציה מתווספת לחנות Google Play, היא תהיה המזהה של האפליקציה. לדוגמה: 'com.example.myapp'. פרטים נוספים זמינים בכתובת https://developer.android.com/studio/build/application-id.

אם האפליקציה תתווסף ל-Apple App Store, היא תהיה המזהה בחנות האפליקציות. לדוגמה, "105169111".

חשוב לשים לב שהגדרת המזהה של חנות האפליקציות נחשבת לפעולה בלתי הפיכה. לאחר קישור אפליקציה, לא ניתן לבטל את הקישור.
displayName

string

פלט בלבד. שם האפליקציה כפי שהוא מופיע בחנות האפליקציות. זהו שדה לפלט בלבד, והוא יכול להיות ריק אם לא ניתן למצוא את האפליקציה בחנות.

AppApprovalState

במצב האישור של אפליקציה לנייד.

טיפוסים בני מנייה (enums)
APP_APPROVAL_STATE_UNSPECIFIED ערך ברירת המחדל לשדה שלא הוגדר. אין להשתמש בו.
ACTION_REQUIRED כדי לאשר את האפליקציה, נדרשת פעולה נוספת מצד המשתמש. פרטים והשלבים הבאים זמינים בכתובת https://support.google.com/admob/answer/10564477.
IN_REVIEW האפליקציה בהמתנה לבדיקה.
APPROVED האפליקציה אושרה ויכולה להציג מודעות.