Method: accounts.apps.list

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

בקשת HTTP

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

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

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

פרמטרים
parent

string

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

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

פרמטרים
pageSize

integer

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

אפליקציה

תיאור של אפליקציה ב-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)

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

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