REST Resource: enterprises.applications

משאב: אפליקציה

מידע על האפליקציה.

ייצוג JSON
{
  "name": string,
  "title": string,
  "permissions": [
    {
      object (ApplicationPermission)
    }
  ],
  "managedProperties": [
    {
      object (ManagedProperty)
    }
  ],
  "iconUrl": string,
  "smallIconUrl": string,
  "appTracks": [
    {
      object (AppTrackInfo)
    }
  ],
  "author": string,
  "playStoreUrl": string,
  "distributionChannel": enum (DistributionChannel),
  "appPricing": enum (AppPricing),
  "description": string,
  "screenshotUrls": [
    string
  ],
  "category": string,
  "recentChanges": string,
  "minAndroidSdkVersion": integer,
  "contentRating": enum (ContentRating),
  "updateTime": string,
  "availableCountries": [
    string
  ],
  "features": [
    enum (AppFeature)
  ],
  "appVersions": [
    {
      object (AppVersion)
    }
  ],
  "fullDescription": string
}
שדות
name

string

שם האפליקציה בתבנית Enterprises/{enterprise}/applications/{packageName}.

title

string

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

permissions[]

object (ApplicationPermission)

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

managedProperties[]

object (ManagedProperty)

קבוצת המאפיינים המנוהלים הזמינים להגדרה מראש של אפליקציה.

iconUrl

string

קישור לתמונה שיכולה לשמש כסמל של האפליקציה. התמונה הזו מתאימה לשימוש בגודל של עד 512 x 512 פיקסלים.

smallIconUrl

string

קישור לתמונה קטנה יותר שיכולה לשמש כסמל של האפליקציה. התמונה הזו מתאימה לשימוש בגודל של עד פיקסל של 128x128.

appTracks[]

object (AppTrackInfo)

מסלולי האפליקציה גלויים לארגון.

author

string

השם של המחבר של האפליקציות (לדוגמה, מפתח האפליקציות).

playStoreUrl

string

קישור לדף הפרטים של האפליקציה (לצרכנים) ב-Google Play.

distributionChannel

enum (DistributionChannel)

איך החבילה זמינה ולמי.

appPricing

enum (AppPricing)

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

description

string

התיאור של קידום המכירות המותאם לשוק המקומי, אם יש כזה.

screenshotUrls[]

string

רשימה של קישורים לצילום מסך שמייצגים את האפליקציה.

category

string

קטגוריית האפליקציה (למשל, RACING, SOCIAL וכו')

recentChanges

string

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

minAndroidSdkVersion

integer

גרסת ה-SDK המינימלית של Android שנדרשת להפעלת האפליקציה.

contentRating

enum (ContentRating)

סיווג התוכן של האפליקציה הזו.

updateTime

string (Timestamp format)

פלט בלבד. הזמן המשוער (בתוך 7 ימים) שבו האפליקציה פורסמה לאחרונה.

חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

availableCountries[]

string

המדינות שבהן האפליקציה זמינה לפי תקן ISO 3166-1 alpha-2.

features[]

enum (AppFeature)

תכונות מעניינות (אם יש) של האפליקציה הזו.

appVersions[]

object (AppVersion)

הגרסאות שזמינות כרגע לאפליקציה הזו.

fullDescription

string

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

ApplicationPermission

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

ייצוג JSON
{
  "permissionId": string,
  "name": string,
  "description": string
}
שדות
permissionId

string

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

name

string

שם ההרשאה. מותאם לשוק המקומי.

description

string

תיאור ארוך יותר של ההרשאה עם פרטים נוספים על הגורמים הרלוונטיים. מותאם לשוק המקומי.

ManagedProperty

נכס מנוהל.

ייצוג JSON
{
  "key": string,
  "type": enum (ManagedPropertyType),
  "title": string,
  "description": string,
  "entries": [
    {
      object (ManagedPropertyEntry)
    }
  ],
  "defaultValue": value,
  "nestedProperties": [
    {
      object (ManagedProperty)
    }
  ]
}
שדות
key

string

המפתח הייחודי שבו האפליקציה משתמשת כדי לזהות את הנכס. למשל "com.google.android.gm.fieldname".

type

enum (ManagedPropertyType)

סוג הנכס.

title

string

שם הנכס. מותאם לשוק המקומי.

description

string

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

entries[]

object (ManagedPropertyEntry)

לנכסים של CHOICE או MULTISELECT, זוהי רשימה של הערכים האפשריים.

defaultValue

value (Value format)

ערך ברירת המחדל של הנכס. ל-BUNDLE_ARRAY נכסים אין ערך ברירת מחדל.

nestedProperties[]

object (ManagedProperty)

של נכסי BUNDLE_ARRAY, זוהי רשימת המאפיינים המקננים. נכס BUNDLE_ARRAY נמצא בעומק של שתי רמות לכל היותר.

ManagedPropertyType

סוג הנכס המנוהל.

טיפוסים בני מנייה (enums)
MANAGED_PROPERTY_TYPE_UNSPECIFIED לא בשימוש.
BOOL מאפיין מסוג בוליאני.
STRING מאפיין של סוג מחרוזת.
INTEGER מאפיין מסוג מספר שלם.
CHOICE בחירה של פריט אחד מתוך קבוצה
MULTISELECT בחירה של מספר פריטים מתוך סט אחד.
HIDDEN הגבלה מוסתרת של סוג המחרוזת (ניתן להשתמש בערך ברירת המחדל כדי להעביר מידע שאי אפשר לשנות, כמו קוד גרסה).
BUNDLE חבילה של נכסים
BUNDLE_ARRAY מערך של חבילות נכסים.

ManagedPropertyEntry

רשומה של נכס מנוהל.

ייצוג JSON
{
  "value": string,
  "name": string
}
שדות
value

string

הערך הקריא למחשבים, שבו יש להשתמש בתצורה. לא מותאם לשוק המקומי.

name

string

שם הערך הקריא (לבני אדם). מותאם לשוק המקומי.

AppTrackInfo

מזהה לציון שם השיוך של מסלול לאפליקציה.

ייצוג JSON
{
  "trackId": string,
  "trackAlias": string
}
שדות
trackId

string

מזהה המעקב הייחודי שלא ניתן לשינוי. המזהה נלקח מה-releaseTrackId בכתובת ה-URL של הדף ב-Play Console. מזהה זה מציג את פרטי הטראק של האפליקציה.

trackAlias

string

שם הטראק המשויך ל-trackId, המוגדר ב-Play Console. אפשר לשנות את השם דרך Play Console.

DistributionChannel

ערוצי הפצה אפשריים.

טיפוסים בני מנייה (enums)
DISTRIBUTION_CHANNEL_UNSPECIFIED לא צוינה.
PUBLIC_GOOGLE_HOSTED החבילה זמינה דרך חנות Play ואינה מוגבלת לארגון ספציפי.
PRIVATE_GOOGLE_HOSTED Package הוא אפליקציה פרטית (מוגבלת לארגון) אך מתארחת ב-Google.
PRIVATE_SELF_HOSTED אפליקציה פרטית (מוגבלת לארגון) ומתארחת באופן פרטי.

AppPricing

מחירים אפשריים לאפליקציות.

טיפוסים בני מנייה (enums)
APP_PRICING_UNSPECIFIED תמחור לא ידוע, משמש לציון אפליקציה מאושרת שאינה זמינה לכלל המשתמשים.
FREE האפליקציה זמינה בחינם.
FREE_WITH_IN_APP_PURCHASE האפליקציה ניתנת בחינם, אך מציעה רכישות מתוך האפליקציה.
PAID האפליקציה בתשלום.

ContentRating

סיווג התוכן שעומד בתקן IARC הכללי.

טיפוסים בני מנייה (enums)
CONTENT_RATING_UNSPECIFIED לא צוינה.
THREE_YEARS תוכן מתאים לגילאי 3 ומעלה בלבד.
SEVEN_YEARS תוכן מתאים לגילאי 7 ומעלה בלבד.
TWELVE_YEARS תוכן מתאים לגילאי 12 ומעלה בלבד.
SIXTEEN_YEARS תוכן מתאים לגילאי 16 ומעלה בלבד.
EIGHTEEN_YEARS תוכן מתאים לגילאי 18 ומעלה בלבד.

AppFeature

תכונות אפשריות של האפליקציה.

טיפוסים בני מנייה (enums)
APP_FEATURE_UNSPECIFIED לא צוינה.
VPN_APP האפליקציה היא VPN.

AppVersion

הסמל הזה מייצג גרסה אחת של האפליקציה.

ייצוג JSON
{
  "versionString": string,
  "versionCode": integer,
  "trackIds": [
    string
  ],
  "production": boolean
}
שדות
versionString

string

המחרוזת שבה משתמש מפתח האפליקציה בחנות Play לזיהוי הגרסה. המחרוזת לא בהכרח ייחודית או מותאמת לשוק המקומי (לדוגמה, המחרוזת יכולה להיות "1.4").

versionCode

integer

מזהה הולך וגדל ייחודי של גרסת האפליקציה.

trackIds[]

string

לעקוב אחרי המזהים שבהם פורסמה גרסת האפליקציה. הוא לא כולל את המסלול לסביבת הייצור (במקום זאת, יש לעיין במסלול הייצור).

production

boolean

אם הערך הוא True, המשמעות היא שהגרסה הזו היא מסלול לסביבת הייצור.

שיטות

get

קבלת מידע על אפליקציה.