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, יוחזרו 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_section} דוגמה: accounts/pub-9876543210987654/apps/0123456789
appId

string

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

string

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

object (ManualAppInfo)

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

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

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

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